Add notify-africa-bulk-sms extension

[Johnndelembi]

Description

Adds the Notify Africa extension for sending SMS from Raycast through the Notify Africa API.

Commands included:

• Send SMS: send one shared message to multiple Tanzania recipients.
• Send Personalized SMS: send one message per recipient using phone | message rows.
• Send SMS from File: parse recipients from a CSV file, preview them locally, then send one shared message.

Security and privacy:

• Uses a required Raycast password preference for the Notify Africa API key.
• Uses the fixed production API origin https://api.notify.africa/api/v1.
• Allows locally pinning one Sender ID UUID for convenience.
• Does not persist recipient lists, message bodies, response data, or send history.
• Parses CSV files locally; files are not uploaded to Notify Africa.

Screenshots

Adds three 2000 x 1250 PNG screenshots in metadata/ for the three view commands.

Verification

• npm run lint
• npm run test
• npm run build

Checklist

• I read the extension guidelines
• I read the documentation about publishing
• I ran npm run build and tested this distribution build in Raycast
• I checked that files in the assets folder are used by the extension itself
• I checked that assets used by the README are placed outside of the metadata folder

[raycastbot]

Congratulations on your new Raycast extension! 🚀

We're currently experiencing a high volume of incoming requests. As a result, the initial review may take up to 15 business days.

Once the PR is approved and merged, the extension will be available on our Store.

[greptile-apps]

Confidence Score: 5/5

[Medium risk] New extension for sending SMS through a third-party service.

The PR appears safe to merge; no outstanding finding or new blocking issue was established.

Summary

Adds a Raycast extension for sending SMS through Notify Africa, with three ways to provide recipients and messages. It checks recipient and message details, asks before sending, and shows the API results.

• Send one shared message to manually entered recipients or a locally parsed CSV.
• Send a different message to each recipient using phone | message rows.
• Keep an API key in Raycast preferences and optionally pin a Sender ID for later use.

_{Reviews (7) · Last reviewed commit: "fix(notify-africa-bulk-sms): reject non-..."}

[socket-security]

No dependency changes detected. Learn more about Socket for GitHub.

👍 No dependency changes detected in pull request

[Johnndelembi]

Addressed the Greptile review items in the latest push:\n\n- Added in-flight guards/loading states to prevent duplicate paid sends.\n- Added three 2000 x 1250 PNG metadata screenshots.\n- Added the Raycast package schema.\n- Switched to the standard Raycast Prettier config.\n- Removed manual preference type declarations and included the generated Raycast env types in TS config.\n- Removed XLSX support and the exceljs dependency; file import is now CSV-only.\n\nLocal verification before publishing: npm run lint, npm run test, npm run build.

[Johnndelembi]

Addressed the CSV BOM review comment in the latest push. now strips a UTF-8 BOM before CSV parsing, with regression coverage for both header-based CSVs and headerless first-column CSVs. Verification: npm run lint, npm run test, npm run build.

[Johnndelembi]

Correction on the previous note: parseRecipientFile now strips a UTF-8 BOM before CSV parsing. Regression coverage was added for both header-based CSV files and headerless first-column CSV files. Verified with npm run lint, npm run test, and npm run build.

[0xdhrv]

Hey @Johnndelembi 👋

Thanks for your contribution 🔥 Nice setup overall — password API key preference, local CSV parsing with a preview, confirmation before paid sends, and solid phone/Sender ID validation with tests.

Here's everything I found in this pass:

Blocking

• issue (blocking): The three metadata/ images look generated / mocked (custom header, green “Review and Send” button, sidebar summary, footer disclaimer) rather than Capture Window shots of the real Raycast Form UI. Please retake them with Capture Window (tick Save to Metadata) so they match the live Form commands, stay 2000×1250, use mock data, and avoid personal data. Docs: https://developers.raycast.com/basics/prepare-an-extension-for-store#screenshots
• issue (blocking): package.json is missing the required platforms field. This is pure TypeScript talking to HTTPS — if you’ve verified on both, use both; otherwise start with macOS-only:

"platforms": ["macOS", "Windows"]

Docs: https://developers.raycast.com/information/manifest

Should fix

• issue: CHANGELOG.md still mentions XLSX import, but XLSX/exceljs were removed. Please drop the XLSX wording so the changelog matches CSV-only behavior.
• issue: On Send SMS from File, after Preview the Detail view doesn’t pass isLoading while sendPreview runs. Please wire isLoading={isSending} (and/or disable Confirm) so a slow request can’t be confirmed twice.

Optional

• suggestion: Add "subtitle": "Notify Africa" on each command so they read clearly in the root search.
• suggestion: You can simplify failure toasts with showFailureToast(error) from @raycast/utils.
• suggestion: Send Personalized SMS currently loops /api/messages/send once per row. Prefer a single POST /api/messages/send-bulk with the messages array (that’s the documented personalized path and avoids N paid round-trips).
• nit (non-blocking): Rename assets/notify 513.png (space in the filename) to something like icon.png and update package.json icon.

When the blocking items are done, press Ready for review. I've converted the PR to a draft until then 😊

Feel free to reach me here or on Slack if anything is unclear.

[0xdhrv]

Looks good to me, approved ✅

[github-actions]

Published to the Raycast Store:
https://raycast.com/john_ndelembi/notify-africa-bulk-sms

[raycastbot]

🎉 🎉 🎉

Such a great contribution deserves a reward, but unfortunately we couldn't find your Raycast account based on your GitHub username (@Johnndelembi).

Please link your GitHub account to your Raycast account to receive your credits and soon be able to exchange them for some swag.