{"id":37871245,"url":"https://github.com/mailsac/mailsac-typescript-api","last_synced_at":"2026-01-16T16:41:06.408Z","repository":{"id":204013997,"uuid":"710911452","full_name":"mailsac/mailsac-typescript-api","owner":"mailsac","description":"Official Mailsac TypeScript/JavaScript Client Library","archived":false,"fork":false,"pushed_at":"2025-03-05T23:09:16.000Z","size":457,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-17T11:18:26.837Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://mailsac.com/api","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mailsac.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-10-27T17:53:57.000Z","updated_at":"2025-03-05T23:09:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"8b80138a-ef56-42bd-8551-b20caf2d5bdc","html_url":"https://github.com/mailsac/mailsac-typescript-api","commit_stats":null,"previous_names":["mailsac/mailsac-typescript-api"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/mailsac/mailsac-typescript-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mailsac%2Fmailsac-typescript-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mailsac%2Fmailsac-typescript-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mailsac%2Fmailsac-typescript-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mailsac%2Fmailsac-typescript-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mailsac","download_url":"https://codeload.github.com/mailsac/mailsac-typescript-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mailsac%2Fmailsac-typescript-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28480064,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-16T16:41:05.589Z","updated_at":"2026-01-16T16:41:06.380Z","avatar_url":"https://github.com/mailsac.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mailsac-typescript-api\n\nOfficial Mailsac TypeScript and JavaScript Client Library\n\nCompiled JavaScript files are published here, as well as TypeScript files and .d typings.\n\nThis library is generated from the openapi spec for mailsac\nwhich can be seen at https://mailsac.com/openapi.yml or https://mailsac.com/openapi.json.\n\n## Usage\n\n```shell\nnpm install @mailsac/api\n```\n\nThe official Mailsac API spec documentation which includes usage examples for this library:\n\nhttps://mailsac.com/docs/api\n\nor see the guides:\n\nhttps://docs.mailsac.com\n\n### [List of all mailsac client methods](methodList.md)\n\n### Usage Example\n\nGet started by instantiating a client library instance with an API key:\n\n```typescript\nimport { Mailsac } from \"@mailsac/api\";\n// or for javascript\n// const { Mailsac } = require(\"@mailsac/api\");\n\nconst mailsac = new Mailsac({ headers: {  \"Mailsac-Key\": process.env.MAILSAC_KEY } }); // api key from mailsac.com/v2/credentials\n```\n\nThen you can use the client to make requests:\n\n```typescript\n// list public messages on a public inbox (no need to create the inbox first!)\nconst messages = await mailsac.addresses.listMessages('test-public@mailsac.com');\nconsole.log({ messages }); // [{...}, {...}, ...]\n\n// reserve an enhanced private address - everybody starts with a free one.\nconst address = await mailsac.addresses.createAddress('test-private@mailsac.com');\nconsole.log({ address }); // { _id: \"test-private@mailsac-com\", ... }\nconst myAddresses = await mailsac.addresses.list();\nconsole.log({ myAddresses }); // [{ _id: \"test-private@mailsac-com\", ... }]\n\n// got to your email client, send an email to the address....\n// ...then check the mail\nconst messages = await mailsac.messages.listMessages('test-private@mailsac.com');\nconsole.log({ messages }); // [{...}, {...}, ...]\n\n```\n\nThere are many more API endpoints which are supported by the client library. Look at\n`./mailsac-client.ts` under the `Mailsac` class to learn more.\n\nMailsac has features like custom subdomains of `msdc.co` which require no DNS config, so you can be receiving\nprivate email for testing in seconds.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmailsac%2Fmailsac-typescript-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmailsac%2Fmailsac-typescript-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmailsac%2Fmailsac-typescript-api/lists"}