@softwarepatterns/am 0.0.1

package/README.md

@@ -0,0 +1,215 @@
+# `@softwarepatterns/am`
+
+Authentication client SDK for **AccountMaker (Am)**.
+
+This package provides a small, stable client for interacting with the AccountMaker authentication API. It is designed for **Node.js applications** and **modern bundlers**, with explicit support for both **ESM** and **CommonJS** consumers.
+
+The SDK focuses on correctness, predictable behavior, and minimal surface area.
+
+---
+
+## Features
+
+* ESM and CommonJS support
+* TypeScript-first API with bundled `.d.ts`
+* Explicit error modeling using Problem Details
+* Token-based authenticated sessions
+* Automatic access-token refresh
+* No runtime dependencies
+* No side effects on import
+
+---
+
+## Requirements
+
+* **Node.js ≥ 18**
+* A runtime with a global `fetch` implementation
+  (Node 18+, Bun, Deno, or a custom `fetchFn`)
+
+---
+
+## Installation
+
+```bash
+npm install @softwarepatterns/am
+```
+
+---
+
+## Importing
+
+### ESM
+
+```ts
+import { Am } from "@softwarepatterns/am";
+```
+
+### CommonJS
+
+```js
+const { Am } = require("@softwarepatterns/am");
+```
+
+---
+
+## Basic usage
+
+### Create a client
+
+```ts
+import { Am } from "@softwarepatterns/am";
+
+const am = new Am({
+  baseUrl: "https://api.accountmaker.com"
+});
+```
+
+If no configuration is provided, the client defaults to:
+
+* `baseUrl: https://api.accountmaker.com`
+* `fetchFn: globalThis.fetch`
+
+---
+
+## Authentication flows
+
+### Login with email and password
+
+```ts
+const result = await am.login({
+  email: "user@example.com",
+  password: "password"
+});
+```
+
+The result contains both session tokens and the authenticated profile.
+
+```ts
+result.session;
+result.profile;
+```
+
+---
+
+### Create an authenticated session
+
+```ts
+const session = am.createAuthSession(result.session);
+```
+
+An `AuthSession` represents an authenticated user and handles token refresh automatically.
+
+---
+
+### Fetch the current user
+
+```ts
+const me = await session.me();
+```
+
+---
+
+### Refresh tokens explicitly
+
+```ts
+await session.refresh();
+```
+
+---
+
+## Error handling
+
+All API errors are surfaced as `AuthError`.
+
+```ts
+import { AuthError } from "@softwarepatterns/am";
+
+try {
+  await am.login({ email, password });
+} catch (err) {
+  if (err instanceof AuthError) {
+    console.log(err.status);
+    console.log(err.title);
+    console.log(err.detail);
+  }
+}
+```
+
+Errors follow the **Problem Details** format (`application/problem+json`).
+
+Unknown or unsupported error responses are converted into a generic problem shape without exposing raw response bodies.
+
+---
+
+## Custom fetch implementation
+
+If the runtime does not provide a global `fetch`, supply one explicitly.
+
+```ts
+const am = new Am({
+  fetchFn: fetch,
+  baseUrl: "https://api.accountmaker.com"
+});
+```
+
+This is useful for:
+
+* Older Node versions
+* Instrumented HTTP clients
+* Testing
+
+---
+
+## TypeScript support
+
+This package ships with bundled type definitions.
+
+```ts
+import type { AuthenticationResult } from "@softwarepatterns/am";
+```
+
+The public API is fully typed. Internal implementation details are not exposed.
+
+---
+
+## Browser support
+
+This SDK does **not currently claim browser runtime support**.
+
+However:
+
+* The package is free of Node-only runtime APIs
+* It can be bundled by modern tools (Vite, Rollup, Webpack)
+
+Browser runtime support may be added in a future release, along with explicit guarantees and tests.
+
+---
+
+## Stability guarantees
+
+The following are guaranteed:
+
+* Stable ESM and CommonJS entry points
+* Stable TypeScript types for exported symbols
+* Compatibility with Node 18, 20, and 22
+* Deterministic build and publish artifacts
+
+The following are **not** guaranteed yet:
+
+* Browser runtime behavior
+* Backward compatibility prior to `1.0.0`
+
+---
+
+## Versioning
+
+This package follows semantic versioning.
+
+* `0.x` releases may introduce breaking changes
+* `1.0.0` will mark a frozen public API
+
+---
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";function t(t){return t.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}function e(n){if(null===n||"object"!=typeof n)return n;if(Array.isArray(n))return n.map(t=>e(t));const s=n,r={};for(const n of Object.keys(s))Object.prototype.hasOwnProperty.call(s,n)&&(r[t(n)]=e(s[n]));return r}function n(t){return t.replace(/[A-Z]/g,t=>`_${t.toLowerCase()}`)}function s(t){if(null===t||"object"!=typeof t)return t;if(Array.isArray(t))return t.map(t=>s(t));const e=t,r={};for(const t of Object.keys(e))Object.prototype.hasOwnProperty.call(e,t)&&(r[n(t)]=s(e[t]));return r}class r extends Error{constructor(t){super(t.title),this.name="AuthError",this.problem=Object.freeze(t)}get type(){return this.problem.type}get title(){return this.problem.title}get status(){return this.problem.status}get code(){return this.problem.code}get detail(){return this.problem.detail}get invalidParams(){return this.problem.invalidParams}}const a={fetchFn:function(){const t=globalThis.fetch;return"function"==typeof t?t:async()=>{throw new Error("Missing fetch implementation. Provide config.fetchFn or use a runtime with global fetch.")}}(),baseUrl:"https://api.accountmaker.com"};const i=async t=>{if(204===t.status)return;const n=await async function(t){const e=t.headers.get("Content-Type")||"";if(!e.includes("application/json")&&!e.includes("+json"))return null;try{return await t.json()}catch{return null}}(t),s=e(n);if(!t.ok){if(function(t){return(t.headers.get("Content-Type")||"").includes("application/problem+json")}(t)&&s&&"object"==typeof s)throw new r(s);throw new r(function(t,e){return{type:"about:blank",title:t.statusText||"Request failed",status:t.status,detail:e}}(t,"string"==typeof n?n:void 0))}return s},o=async({fetchFn:t,baseUrl:e},n,r={})=>{const a=new URLSearchParams(s(r)).toString(),o=a?`${e}${n}?${a}`:`${e}${n}`,c=await t(o,{method:"GET",headers:{Accept:"application/json"}});return i(c)},c=async({fetchFn:t,baseUrl:e},n,r)=>{const a=await t(`${e}${n}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s(r))});return i(a)},h=async({accessToken:t},{fetchFn:e,baseUrl:n},r,a={})=>{const o=new URLSearchParams(s(a)).toString(),c=o?`${n}${r}?${o}`:`${n}${r}`,h=await e(c,{method:"GET",headers:{Accept:"application/json",Authorization:`Bearer ${t}`}});return i(h)};class u{constructor(t,e){this.tokens=t,this.config={...a,...e},this.lastUpdated=new Date}get accessToken(){return this.tokens.accessToken}get refreshToken(){return this.tokens.refreshToken}get idToken(){return this.tokens.idToken}get tokenType(){return this.tokens.tokenType}get expiresIn(){return this.tokens.expiresIn}get lastUpdatedAt(){return this.lastUpdated}get expiresAt(){return new Date(this.lastUpdated.getTime()+1e3*this.expiresIn)}isExpired(){return Date.now()>=this.expiresAt.getTime()-6e4}async fetch(t,e={}){const{fetchFn:n}=this.config;return this.isExpired()&&await this.refresh(),await n(t,{...e,headers:{...e.headers||{},Authorization:`Bearer ${this.tokens.accessToken}`}})}async refresh(){const{fetchFn:t,baseUrl:e}=this.config,n=await t(`${e}/auth/refresh`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s({refreshToken:this.tokens.refreshToken}))}),r=await i(n);this.tokens=r,this.lastUpdated=new Date}async sendVerificationEmail(){await(async({accessToken:t},{fetchFn:e,baseUrl:n},r,a)=>{const o=await e(`${n}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t}`},body:JSON.stringify(s(a))});return i(o)})(this,this.config,"/auth/send-verification-email",{})}async me(){return await h(this,this.config,"/auth/me",{})}async user(t){return await h(this,this.config,`/auth/user/${t}`,{})}}class p{constructor(t){this.options={...a,...t}}static createAuthSession(t,e){return new p(e).createAuthSession(t)}createAuthSession(t){return new u(t,this.options)}static async acceptInvite(t,e){return new p(e).acceptInvite(t)}async acceptInvite(t){return await o(this.options,"/auth/accept-invite",t)}static async checkEmail(t,e){return new p(e).checkEmail(t)}async checkEmail(t){return c(this.options,"/auth/check-email",t)}static async csrfSession(t){return new p(t).csrfSession()}async csrfSession(){return o(this.options,"/auth/csrf-session")}static async csrfToken(t){return new p(t).csrfToken()}async csrfToken(){return o(this.options,"/auth/csrf-token")}static async login(t,e){return new p(e).login(t)}async login(t){return await c(this.options,"/auth/login",t)}static async tokenLogin(t,e){return new p(e).tokenLogin(t)}async tokenLogin(t){const e=this.options;return await o(e,"/auth/token-login",{token:t})}static async refresh(t,e){return new p(e).refresh(t)}async refresh(t){return await c(this.options,"/auth/refresh",{refreshToken:t})}static async register(t,e){return new p(e).register(t)}async register(t){return await c(this.options,"/auth/register",t)}static async resetPassword(t,e){return new p(e).resetPassword(t)}async resetPassword(t){return c(this.options,"/auth/reset-password",t)}static async sendMagicLink(t,e){return new p(e).sendMagicLink(t)}async sendMagicLink(t){return c(this.options,"/auth/send-magic-link",t)}static async sendPasswordReset(t,e){return new p(e).sendPasswordReset(t)}async sendPasswordReset(t){return c(this.options,"/auth/send-password-reset",t)}}exports.Am=p,exports.AuthError=r,exports.AuthSession=u;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/auth.ts"],"sourcesContent":[null],"names":["camelCaseStr","str","replace","_","letter","toUpperCase","camelCaseObj","input","Array","isArray","map","item","obj","result","key","Object","keys","prototype","hasOwnProperty","call","snakeCaseStr","toLowerCase","snakeCaseObj","AuthError","Error","constructor","problem","super","title","this","name","freeze","type","status","code","detail","invalidParams","defaultConfig","fetchFn","f","globalThis","fetch","async","defaultFetchFn","baseUrl","handleResponse","res","raw","contentType","headers","get","includes","json","readJsonSafe","ok","isProblemJson","statusText","toGenericProblem","undefined","unauthGet","path","query","qs","URLSearchParams","toString","url","method","Accept","unauthPost","body","JSON","stringify","authGet","accessToken","Authorization","AuthSession","tokens","config","lastUpdated","Date","refreshToken","idToken","tokenType","expiresIn","lastUpdatedAt","expiresAt","getTime","isExpired","now","init","refresh","sendVerificationEmail","authPost","me","user","id","Am","options","createAuthSession","acceptInvite","checkEmail","csrfSession","csrfToken","login","tokenLogin","token","register","resetPassword","sendMagicLink","sendPasswordReset"],"mappings":"aAmBA,SAASA,EAAaC,GACpB,OAAOA,EAAIC,QAAQ,YAAa,CAACC,EAAGC,IAAWA,EAAOC,cACxD,CAEA,SAASC,EAAaC,GACpB,GAAc,OAAVA,GAAmC,iBAAVA,EAC3B,OAAOA,EAGT,GAAIC,MAAMC,QAAQF,GAChB,OAAOA,EAAMG,IAAKC,GAASL,EAAaK,IAG1C,MAAMC,EAAML,EACNM,EAAkC,CAAA,EAExC,IAAK,MAAMC,KAAOC,OAAOC,KAAKJ,GACxBG,OAAOE,UAAUC,eAAeC,KAAKP,EAAKE,KAC5CD,EAAOb,EAAac,IAAQR,EAAaM,EAAIE,KAIjD,OAAOD,CACT,CAEA,SAASO,EAAanB,GACpB,OAAOA,EAAIC,QAAQ,SAAWE,GAAW,IAAIA,EAAOiB,gBACtD,CAEA,SAASC,EAAaf,GACpB,GAAc,OAAVA,GAAmC,iBAAVA,EAC3B,OAAOA,EAGT,GAAIC,MAAMC,QAAQF,GAChB,OAAOA,EAAMG,IAAKC,GAASW,EAAaX,IAG1C,MAAMC,EAAML,EACNM,EAAkC,CAAA,EAExC,IAAK,MAAMC,KAAOC,OAAOC,KAAKJ,GACxBG,OAAOE,UAAUC,eAAeC,KAAKP,EAAKE,KAC5CD,EAAOO,EAAaN,IAAQQ,EAAaV,EAAIE,KAIjD,OAAOD,CACT,CAEM,MAAOU,UAAkBC,MAG7B,WAAAC,CAAYC,GACVC,MAAMD,EAAQE,OACdC,KAAKC,KAAO,YACZD,KAAKH,QAAUX,OAAOgB,OAAOL,EAC/B,CACA,QAAIM,GACF,OAAOH,KAAKH,QAAQM,IACtB,CACA,SAAIJ,GACF,OAAOC,KAAKH,QAAQE,KACtB,CACA,UAAIK,GACF,OAAOJ,KAAKH,QAAQO,MACtB,CACA,QAAIC,GACF,OAAOL,KAAKH,QAAQQ,IACtB,CACA,UAAIC,GACF,OAAON,KAAKH,QAAQS,MACtB,CACA,iBAAIC,GACF,OAAOP,KAAKH,QAAQU,aACtB,EAmBF,MAAMC,EAAgB,CACpBC,QAZF,WACE,MAAMC,EAAKC,WAAmBC,MAC9B,MAAiB,mBAANF,EAAyBA,EAE7BG,UACL,MAAM,IAAIlB,MACR,4FAGN,CAGWmB,GACTC,QAAS,gCA+BX,MAAMC,EAAiBH,MAAOI,IAC5B,GAAmB,MAAfA,EAAIb,OACN,OAGF,MAAMc,QA5BRL,eAA4BI,GAC1B,MAAME,EAAcF,EAAIG,QAAQC,IAAI,iBAAmB,GACvD,IACGF,EAAYG,SAAS,sBACrBH,EAAYG,SAAS,SAEtB,OAAO,KACT,IACE,aAAaL,EAAIM,MACnB,CAAE,MACA,OAAO,IACT,CACF,CAgBoBC,CAAaP,GACzBM,EAAO9C,EAAayC,GAE1B,IAAKD,EAAIQ,GAAI,CACX,GArCJ,SAAuBR,GAErB,OADoBA,EAAIG,QAAQC,IAAI,iBAAmB,IACpCC,SAAS,2BAC9B,CAkCQI,CAAcT,IAAQM,GAAwB,iBAATA,EACvC,MAAM,IAAI7B,EAAU6B,GAEtB,MAAM,IAAI7B,EArBd,SAA0BuB,EAAeX,GACvC,MAAO,CACLH,KAAM,cACNJ,MAAOkB,EAAIU,YAAc,iBACzBvB,OAAQa,EAAIb,OACZE,SAEJ,CAeMsB,CAAiBX,EAAoB,iBAARC,EAAmBA,OAAMW,GAE1D,CAEA,OAAON,GAMHO,EAAYjB,OACdJ,UAASM,WACXgB,EACAC,EAAgC,MAEhC,MAAMC,EAAK,IAAIC,gBACbzC,EAAauC,IACbG,WACIC,EAAMH,EAAK,GAAGlB,IAAUgB,KAAQE,IAAO,GAAGlB,IAAUgB,IACpDd,QAAYR,EAAQ2B,EAAK,CAC7BC,OAAQ,MACRjB,QAAS,CACPkB,OAAQ,sBAGZ,OAAOtB,EAAeC,IAMlBsB,EAAa1B,OACfJ,UAASM,WACXgB,EACAS,KAEA,MAAMvB,QAAYR,EAAQ,GAAGM,IAAUgB,IAAQ,CAC7CM,OAAQ,OACRjB,QAAS,CACP,eAAgB,oBAElBoB,KAAMC,KAAKC,UAAUjD,EAAa+C,MAEpC,OAAOxB,EAAeC,IAGlB0B,EAAU9B,OACZ+B,gBACAnC,UAASM,WACXgB,EACAC,EAAgC,MAEhC,MAAMC,EAAK,IAAIC,gBACbzC,EAAauC,IACbG,WACIC,EAAMH,EAAK,GAAGlB,IAAUgB,KAAQE,IAAO,GAAGlB,IAAUgB,IACpDd,QAAYR,EAAQ2B,EAAK,CAC7BC,OAAQ,MACRjB,QAAS,CACPkB,OAAQ,mBACRO,cAAe,UAAUD,OAG7B,OAAO5B,EAAeC,UA2BX6B,EAKX,WAAAlD,CAAYmD,EAAuBC,GACjChD,KAAK+C,OAASA,EACd/C,KAAKgD,OAAS,IACTxC,KACAwC,GAELhD,KAAKiD,YAAc,IAAIC,IACzB,CAEA,eAAIN,GACF,OAAO5C,KAAK+C,OAAOH,WACrB,CACA,gBAAIO,GACF,OAAOnD,KAAK+C,OAAOI,YACrB,CACA,WAAIC,GACF,OAAOpD,KAAK+C,OAAOK,OACrB,CACA,aAAIC,GACF,OAAOrD,KAAK+C,OAAOM,SACrB,CACA,aAAIC,GACF,OAAOtD,KAAK+C,OAAOO,SACrB,CACA,iBAAIC,GACF,OAAOvD,KAAKiD,WACd,CACA,aAAIO,GACF,OAAO,IAAIN,KAAKlD,KAAKiD,YAAYQ,UAA6B,IAAjBzD,KAAKsD,UACpD,CAEA,SAAAI,GACE,OAAOR,KAAKS,OAAS3D,KAAKwD,UAAUC,UAlRtB,GAmRhB,CAQA,WAAM7C,CAAMwB,EAA6BwB,EAAoB,IAC3D,MAAMnD,QAAEA,GAAYT,KAAKgD,OAOzB,OAJIhD,KAAK0D,mBACD1D,KAAK6D,gBAGApD,EAAQ2B,EAAK,IACrBwB,EACHxC,QAAS,IACHwC,EAAKxC,SAAW,GACpByB,cAAe,UAAU7C,KAAK+C,OAAOH,gBAG3C,CAEA,aAAMiB,GACJ,MAAMpD,QAAEA,EAAOM,QAAEA,GAAYf,KAAKgD,OAC5B/B,QAAYR,EAAQ,GAAGM,iBAAwB,CACnDsB,OAAQ,OACRjB,QAAS,CACP,eAAgB,oBAElBoB,KAAMC,KAAKC,UACTjD,EAAa,CAAE0D,aAAcnD,KAAK+C,OAAOI,kBAGvC5B,QAAaP,EAAeC,GAClCjB,KAAK+C,OAASxB,EACdvB,KAAKiD,YAAc,IAAIC,IACzB,CAEA,2BAAMY,QAjGSjD,QACb+B,gBACAnC,UAASM,WACXgB,EACAS,KAEA,MAAMvB,QAAYR,EAAQ,GAAGM,IAAUgB,IAAQ,CAC7CM,OAAQ,OACRjB,QAAS,CACP,eAAgB,mBAChByB,cAAe,UAAUD,KAE3BJ,KAAMC,KAAKC,UAAUjD,EAAa+C,MAGpC,OAAOxB,EAAeC,IAmFd8C,CAAS/D,KAAMA,KAAKgD,OAAQ,gCAAiC,CAAA,EACrE,CAEA,QAAMgB,GACJ,aAAarB,EAAQ3C,KAAMA,KAAKgD,OAAQ,WAAY,GACtD,CAEA,UAAMiB,CAAKC,GACT,aAAavB,EAAQ3C,KAAMA,KAAKgD,OAAQ,cAAckB,IAAM,GAC9D,QAGWC,EAGX,WAAAvE,CAAYoD,GACVhD,KAAKoE,QAAU,IAAK5D,KAAkBwC,EACxC,CAEA,wBAAOqB,CACLtB,EACAC,GAEA,OAAO,IAAImB,EAAGnB,GAAQqB,kBAAkBtB,EAC1C,CAEA,iBAAAsB,CAAkBtB,GAChB,OAAO,IAAID,EAAYC,EAAQ/C,KAAKoE,QACtC,CAEA,yBAAaE,CACXtC,EAIAgB,GAEA,OAAO,IAAImB,EAAGnB,GAAQsB,aAAatC,EACrC,CAEA,kBAAMsC,CAAatC,GAIjB,aAAaF,EAAU9B,KAAKoE,QAAS,sBAAuBpC,EAC9D,CAEA,uBAAauC,CACX/B,EACAQ,GAMA,OAAO,IAAImB,EAAGnB,GAAQuB,WAAW/B,EACnC,CAEA,gBAAM+B,CAAW/B,GASf,OAAOD,EAAWvC,KAAKoE,QAAS,oBAAqB5B,EACvD,CAEA,wBAAagC,CACXxB,GAEA,OAAO,IAAImB,EAAGnB,GAAQwB,aACxB,CAEA,iBAAMA,GACJ,OAAO1C,EAAU9B,KAAKoE,QAAS,qBACjC,CAEA,sBAAaK,CACXzB,GAEA,OAAO,IAAImB,EAAGnB,GAAQyB,WACxB,CAEA,eAAMA,GACJ,OAAO3C,EAAU9B,KAAKoE,QAAS,mBACjC,CAEA,kBAAaM,CACXlC,EAKAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQ0B,MAAMlC,EAC9B,CAEA,WAAMkC,CAAMlC,GAKV,aAAaD,EAAWvC,KAAKoE,QAAS,cAAe5B,EACvD,CAEA,uBAAamC,CACXC,EACA5B,GAEA,OAAO,IAAImB,EAAGnB,GAAQ2B,WAAWC,EACnC,CAEA,gBAAMD,CAAWC,GACf,MAAMR,EAAUpE,KAAKoE,QACrB,aAAatC,EAAUsC,EAAS,oBAAqB,CACnDQ,SAEJ,CAEA,oBAAaf,CACXV,EACAH,GAEA,OAAO,IAAImB,EAAGnB,GAAQa,QAAQV,EAChC,CAEA,aAAMU,CAAQV,GACZ,aAAaZ,EAAWvC,KAAKoE,QAAS,gBAAiB,CACrDjB,gBAEJ,CAEA,qBAAa0B,CACXrC,EAKAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQ6B,SAASrC,EACjC,CAEA,cAAMqC,CAASrC,GAKb,aAAaD,EAAWvC,KAAKoE,QAAS,iBAAkB5B,EAC1D,CAEA,0BAAasC,CACXtC,EAIAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQ8B,cAActC,EACtC,CAEA,mBAAMsC,CAActC,GAIlB,OAAOD,EAAWvC,KAAKoE,QAAS,uBAAwB5B,EAC1D,CAEA,0BAAauC,CACXvC,EAIAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQ+B,cAAcvC,EACtC,CAEA,mBAAMuC,CAAcvC,GAIlB,OAAOD,EAAWvC,KAAKoE,QAAS,wBAAyB5B,EAC3D,CAEA,8BAAawC,CACXxC,EAIAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQgC,kBAAkBxC,EAC1C,CAEA,uBAAMwC,CAAkBxC,GAItB,OAAOD,EAAWvC,KAAKoE,QAAS,4BAA6B5B,EAC/D"}

package/dist/index.d.ts

@@ -0,0 +1,205 @@
+type ProblemDetails = {
+    type: string;
+    title: string;
+    status: number;
+    code?: string;
+    detail?: string;
+    invalidParams?: {
+        in: "body" | "cookie" | "header" | "query" | "path";
+        path: string;
+        type: string;
+        received: unknown;
+        expected?: string;
+    }[];
+};
+type ClientId = `cid${string}`;
+type UserId = `uid${string}`;
+type AccountId = `acc${string}`;
+type MembershipId = `mbr${string}`;
+type UserStatus = "active" | "trial" | "past_due" | "suspended" | "closed";
+type UserResource = {
+    id: UserId;
+    accountId: AccountId;
+    status: UserStatus;
+    preferredMembershipId: MembershipId | null;
+};
+type UserIdentity = {
+    id: UserId;
+    avatarUrl: string | null;
+    externalId: string | null;
+    givenName: string | null;
+    familyName: string | null;
+    displayName: string | null;
+    preferredLanguage: string | null;
+    locale: string | null;
+    timezone: string | null;
+};
+type MembershipRole = "owner" | "member" | "viewer";
+type Membership = {
+    id: MembershipId;
+    userId: UserId;
+    accountId: AccountId;
+    role: MembershipRole;
+};
+type EmailCredential = {
+    id: string;
+    email: string | null;
+    hashedEmail: string | null;
+    hashedPassword: string | null;
+    emailVerifiedAt: string | null;
+};
+type SessionTokens = {
+    accessToken: string;
+    refreshToken: string;
+    tokenType: "Bearer";
+    expiresIn: number;
+    idToken?: string;
+};
+type SessionProfile = UserResource & {
+    identity: UserIdentity;
+    emailCredentials: EmailCredential[];
+    memberships: Membership[];
+    activeMembership: Membership | null;
+};
+type AuthenticationResult = {
+    session: SessionTokens;
+    profile: SessionProfile;
+};
+type EmailCheckStatus = "active" | "inactive";
+type LoginMethod = "email_password" | "magic_link";
+
+type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+declare class AuthError extends Error {
+    readonly problem: ProblemDetails;
+    constructor(problem: ProblemDetails);
+    get type(): string;
+    get title(): string;
+    get status(): number;
+    get code(): string | undefined;
+    get detail(): string | undefined;
+    get invalidParams(): ProblemDetails["invalidParams"] | undefined;
+}
+type Config = {
+    fetchFn: FetchFn;
+    baseUrl: string;
+};
+declare class AuthSession {
+    private tokens;
+    private config;
+    private lastUpdated;
+    constructor(tokens: SessionTokens, config: Partial<Config>);
+    get accessToken(): string;
+    get refreshToken(): string;
+    get idToken(): string | undefined;
+    get tokenType(): "Bearer";
+    get expiresIn(): number;
+    get lastUpdatedAt(): Date;
+    get expiresAt(): Date;
+    isExpired(): boolean;
+    /**
+     * Fetch with automatic token refresh.
+     *
+     * If the access token is expired, it will be refreshed before making the request. The
+     * Authorization header will be set with the current access token.
+     */
+    fetch(url: string | URL | Request, init?: RequestInit): Promise<Response>;
+    refresh(): Promise<void>;
+    sendVerificationEmail(): Promise<void>;
+    me(): Promise<SessionProfile>;
+    user(id: UserId): Promise<UserResource>;
+}
+declare class Am {
+    private options;
+    constructor(config?: Partial<Config>);
+    static createAuthSession(tokens: SessionTokens, config?: Partial<Config>): AuthSession;
+    createAuthSession(tokens: SessionTokens): AuthSession;
+    static acceptInvite(query: {
+        clientId: ClientId;
+        token: string;
+    }, config?: Partial<Config>): Promise<AuthenticationResult>;
+    acceptInvite(query: {
+        clientId: ClientId;
+        token: string;
+    }): Promise<AuthenticationResult>;
+    static checkEmail(body: {
+        clientId: ClientId;
+        email: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<{
+        status: EmailCheckStatus;
+        preferred: LoginMethod[];
+        available: LoginMethod[];
+    }>;
+    checkEmail(body: {
+        clientId: ClientId;
+        email: string;
+        csrfToken?: string;
+    }): Promise<{
+        status: EmailCheckStatus;
+        preferred: LoginMethod[];
+        available: LoginMethod[];
+    }>;
+    static csrfSession(config?: Partial<Config>): Promise<{
+        csrfToken: string;
+    }>;
+    csrfSession(): Promise<{
+        csrfToken: string;
+    }>;
+    static csrfToken(config?: Partial<Config>): Promise<{
+        csrfToken: string;
+    }>;
+    csrfToken(): Promise<{
+        csrfToken: string;
+    }>;
+    static login(body: {
+        email: string;
+        password: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<AuthenticationResult>;
+    login(body: {
+        email: string;
+        password: string;
+        csrfToken?: string;
+    }): Promise<AuthenticationResult>;
+    static tokenLogin(token: string, config?: Partial<Config>): Promise<AuthenticationResult>;
+    tokenLogin(token: string): Promise<AuthenticationResult>;
+    static refresh(refreshToken: string, config?: Partial<Config>): Promise<SessionTokens>;
+    refresh(refreshToken: string): Promise<SessionTokens>;
+    static register(body: {
+        email: string;
+        password: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<AuthenticationResult>;
+    register(body: {
+        email: string;
+        password: string;
+        csrfToken?: string;
+    }): Promise<AuthenticationResult>;
+    static resetPassword(body: {
+        token: string;
+        newPassword: string;
+    }, config?: Partial<Config>): Promise<void>;
+    resetPassword(body: {
+        token: string;
+        newPassword: string;
+    }): Promise<void>;
+    static sendMagicLink(body: {
+        email: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<void>;
+    sendMagicLink(body: {
+        email: string;
+        csrfToken?: string;
+    }): Promise<void>;
+    static sendPasswordReset(body: {
+        email: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<void>;
+    sendPasswordReset(body: {
+        email: string;
+        csrfToken?: string;
+    }): Promise<void>;
+}
+
+export { Am, AuthError, AuthSession };
+export type { AuthenticationResult, ClientId, EmailCheckStatus, LoginMethod, ProblemDetails, SessionProfile, SessionTokens, UserId, UserResource };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+function t(t){return t.replace(/_([a-z])/g,(t,e)=>e.toUpperCase())}function e(n){if(null===n||"object"!=typeof n)return n;if(Array.isArray(n))return n.map(t=>e(t));const s=n,r={};for(const n of Object.keys(s))Object.prototype.hasOwnProperty.call(s,n)&&(r[t(n)]=e(s[n]));return r}function n(t){return t.replace(/[A-Z]/g,t=>`_${t.toLowerCase()}`)}function s(t){if(null===t||"object"!=typeof t)return t;if(Array.isArray(t))return t.map(t=>s(t));const e=t,r={};for(const t of Object.keys(e))Object.prototype.hasOwnProperty.call(e,t)&&(r[n(t)]=s(e[t]));return r}class r extends Error{constructor(t){super(t.title),this.name="AuthError",this.problem=Object.freeze(t)}get type(){return this.problem.type}get title(){return this.problem.title}get status(){return this.problem.status}get code(){return this.problem.code}get detail(){return this.problem.detail}get invalidParams(){return this.problem.invalidParams}}const a={fetchFn:function(){const t=globalThis.fetch;return"function"==typeof t?t:async()=>{throw new Error("Missing fetch implementation. Provide config.fetchFn or use a runtime with global fetch.")}}(),baseUrl:"https://api.accountmaker.com"};const i=async t=>{if(204===t.status)return;const n=await async function(t){const e=t.headers.get("Content-Type")||"";if(!e.includes("application/json")&&!e.includes("+json"))return null;try{return await t.json()}catch{return null}}(t),s=e(n);if(!t.ok){if(function(t){return(t.headers.get("Content-Type")||"").includes("application/problem+json")}(t)&&s&&"object"==typeof s)throw new r(s);throw new r(function(t,e){return{type:"about:blank",title:t.statusText||"Request failed",status:t.status,detail:e}}(t,"string"==typeof n?n:void 0))}return s},o=async({fetchFn:t,baseUrl:e},n,r={})=>{const a=new URLSearchParams(s(r)).toString(),o=a?`${e}${n}?${a}`:`${e}${n}`,c=await t(o,{method:"GET",headers:{Accept:"application/json"}});return i(c)},c=async({fetchFn:t,baseUrl:e},n,r)=>{const a=await t(`${e}${n}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s(r))});return i(a)},h=async({accessToken:t},{fetchFn:e,baseUrl:n},r,a={})=>{const o=new URLSearchParams(s(a)).toString(),c=o?`${n}${r}?${o}`:`${n}${r}`,h=await e(c,{method:"GET",headers:{Accept:"application/json",Authorization:`Bearer ${t}`}});return i(h)};class u{constructor(t,e){this.tokens=t,this.config={...a,...e},this.lastUpdated=new Date}get accessToken(){return this.tokens.accessToken}get refreshToken(){return this.tokens.refreshToken}get idToken(){return this.tokens.idToken}get tokenType(){return this.tokens.tokenType}get expiresIn(){return this.tokens.expiresIn}get lastUpdatedAt(){return this.lastUpdated}get expiresAt(){return new Date(this.lastUpdated.getTime()+1e3*this.expiresIn)}isExpired(){return Date.now()>=this.expiresAt.getTime()-6e4}async fetch(t,e={}){const{fetchFn:n}=this.config;return this.isExpired()&&await this.refresh(),await n(t,{...e,headers:{...e.headers||{},Authorization:`Bearer ${this.tokens.accessToken}`}})}async refresh(){const{fetchFn:t,baseUrl:e}=this.config,n=await t(`${e}/auth/refresh`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s({refreshToken:this.tokens.refreshToken}))}),r=await i(n);this.tokens=r,this.lastUpdated=new Date}async sendVerificationEmail(){await(async({accessToken:t},{fetchFn:e,baseUrl:n},r,a)=>{const o=await e(`${n}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t}`},body:JSON.stringify(s(a))});return i(o)})(this,this.config,"/auth/send-verification-email",{})}async me(){return await h(this,this.config,"/auth/me",{})}async user(t){return await h(this,this.config,`/auth/user/${t}`,{})}}class p{constructor(t){this.options={...a,...t}}static createAuthSession(t,e){return new p(e).createAuthSession(t)}createAuthSession(t){return new u(t,this.options)}static async acceptInvite(t,e){return new p(e).acceptInvite(t)}async acceptInvite(t){return await o(this.options,"/auth/accept-invite",t)}static async checkEmail(t,e){return new p(e).checkEmail(t)}async checkEmail(t){return c(this.options,"/auth/check-email",t)}static async csrfSession(t){return new p(t).csrfSession()}async csrfSession(){return o(this.options,"/auth/csrf-session")}static async csrfToken(t){return new p(t).csrfToken()}async csrfToken(){return o(this.options,"/auth/csrf-token")}static async login(t,e){return new p(e).login(t)}async login(t){return await c(this.options,"/auth/login",t)}static async tokenLogin(t,e){return new p(e).tokenLogin(t)}async tokenLogin(t){const e=this.options;return await o(e,"/auth/token-login",{token:t})}static async refresh(t,e){return new p(e).refresh(t)}async refresh(t){return await c(this.options,"/auth/refresh",{refreshToken:t})}static async register(t,e){return new p(e).register(t)}async register(t){return await c(this.options,"/auth/register",t)}static async resetPassword(t,e){return new p(e).resetPassword(t)}async resetPassword(t){return c(this.options,"/auth/reset-password",t)}static async sendMagicLink(t,e){return new p(e).sendMagicLink(t)}async sendMagicLink(t){return c(this.options,"/auth/send-magic-link",t)}static async sendPasswordReset(t,e){return new p(e).sendPasswordReset(t)}async sendPasswordReset(t){return c(this.options,"/auth/send-password-reset",t)}}export{p as Am,r as AuthError,u as AuthSession};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/auth.ts"],"sourcesContent":[null],"names":["camelCaseStr","str","replace","_","letter","toUpperCase","camelCaseObj","input","Array","isArray","map","item","obj","result","key","Object","keys","prototype","hasOwnProperty","call","snakeCaseStr","toLowerCase","snakeCaseObj","AuthError","Error","constructor","problem","super","title","this","name","freeze","type","status","code","detail","invalidParams","defaultConfig","fetchFn","f","globalThis","fetch","async","defaultFetchFn","baseUrl","handleResponse","res","raw","contentType","headers","get","includes","json","readJsonSafe","ok","isProblemJson","statusText","toGenericProblem","undefined","unauthGet","path","query","qs","URLSearchParams","toString","url","method","Accept","unauthPost","body","JSON","stringify","authGet","accessToken","Authorization","AuthSession","tokens","config","lastUpdated","Date","refreshToken","idToken","tokenType","expiresIn","lastUpdatedAt","expiresAt","getTime","isExpired","now","init","refresh","sendVerificationEmail","authPost","me","user","id","Am","options","createAuthSession","acceptInvite","checkEmail","csrfSession","csrfToken","login","tokenLogin","token","register","resetPassword","sendMagicLink","sendPasswordReset"],"mappings":"AAmBA,SAASA,EAAaC,GACpB,OAAOA,EAAIC,QAAQ,YAAa,CAACC,EAAGC,IAAWA,EAAOC,cACxD,CAEA,SAASC,EAAaC,GACpB,GAAc,OAAVA,GAAmC,iBAAVA,EAC3B,OAAOA,EAGT,GAAIC,MAAMC,QAAQF,GAChB,OAAOA,EAAMG,IAAKC,GAASL,EAAaK,IAG1C,MAAMC,EAAML,EACNM,EAAkC,CAAA,EAExC,IAAK,MAAMC,KAAOC,OAAOC,KAAKJ,GACxBG,OAAOE,UAAUC,eAAeC,KAAKP,EAAKE,KAC5CD,EAAOb,EAAac,IAAQR,EAAaM,EAAIE,KAIjD,OAAOD,CACT,CAEA,SAASO,EAAanB,GACpB,OAAOA,EAAIC,QAAQ,SAAWE,GAAW,IAAIA,EAAOiB,gBACtD,CAEA,SAASC,EAAaf,GACpB,GAAc,OAAVA,GAAmC,iBAAVA,EAC3B,OAAOA,EAGT,GAAIC,MAAMC,QAAQF,GAChB,OAAOA,EAAMG,IAAKC,GAASW,EAAaX,IAG1C,MAAMC,EAAML,EACNM,EAAkC,CAAA,EAExC,IAAK,MAAMC,KAAOC,OAAOC,KAAKJ,GACxBG,OAAOE,UAAUC,eAAeC,KAAKP,EAAKE,KAC5CD,EAAOO,EAAaN,IAAQQ,EAAaV,EAAIE,KAIjD,OAAOD,CACT,CAEM,MAAOU,UAAkBC,MAG7B,WAAAC,CAAYC,GACVC,MAAMD,EAAQE,OACdC,KAAKC,KAAO,YACZD,KAAKH,QAAUX,OAAOgB,OAAOL,EAC/B,CACA,QAAIM,GACF,OAAOH,KAAKH,QAAQM,IACtB,CACA,SAAIJ,GACF,OAAOC,KAAKH,QAAQE,KACtB,CACA,UAAIK,GACF,OAAOJ,KAAKH,QAAQO,MACtB,CACA,QAAIC,GACF,OAAOL,KAAKH,QAAQQ,IACtB,CACA,UAAIC,GACF,OAAON,KAAKH,QAAQS,MACtB,CACA,iBAAIC,GACF,OAAOP,KAAKH,QAAQU,aACtB,EAmBF,MAAMC,EAAgB,CACpBC,QAZF,WACE,MAAMC,EAAKC,WAAmBC,MAC9B,MAAiB,mBAANF,EAAyBA,EAE7BG,UACL,MAAM,IAAIlB,MACR,4FAGN,CAGWmB,GACTC,QAAS,gCA+BX,MAAMC,EAAiBH,MAAOI,IAC5B,GAAmB,MAAfA,EAAIb,OACN,OAGF,MAAMc,QA5BRL,eAA4BI,GAC1B,MAAME,EAAcF,EAAIG,QAAQC,IAAI,iBAAmB,GACvD,IACGF,EAAYG,SAAS,sBACrBH,EAAYG,SAAS,SAEtB,OAAO,KACT,IACE,aAAaL,EAAIM,MACnB,CAAE,MACA,OAAO,IACT,CACF,CAgBoBC,CAAaP,GACzBM,EAAO9C,EAAayC,GAE1B,IAAKD,EAAIQ,GAAI,CACX,GArCJ,SAAuBR,GAErB,OADoBA,EAAIG,QAAQC,IAAI,iBAAmB,IACpCC,SAAS,2BAC9B,CAkCQI,CAAcT,IAAQM,GAAwB,iBAATA,EACvC,MAAM,IAAI7B,EAAU6B,GAEtB,MAAM,IAAI7B,EArBd,SAA0BuB,EAAeX,GACvC,MAAO,CACLH,KAAM,cACNJ,MAAOkB,EAAIU,YAAc,iBACzBvB,OAAQa,EAAIb,OACZE,SAEJ,CAeMsB,CAAiBX,EAAoB,iBAARC,EAAmBA,OAAMW,GAE1D,CAEA,OAAON,GAMHO,EAAYjB,OACdJ,UAASM,WACXgB,EACAC,EAAgC,MAEhC,MAAMC,EAAK,IAAIC,gBACbzC,EAAauC,IACbG,WACIC,EAAMH,EAAK,GAAGlB,IAAUgB,KAAQE,IAAO,GAAGlB,IAAUgB,IACpDd,QAAYR,EAAQ2B,EAAK,CAC7BC,OAAQ,MACRjB,QAAS,CACPkB,OAAQ,sBAGZ,OAAOtB,EAAeC,IAMlBsB,EAAa1B,OACfJ,UAASM,WACXgB,EACAS,KAEA,MAAMvB,QAAYR,EAAQ,GAAGM,IAAUgB,IAAQ,CAC7CM,OAAQ,OACRjB,QAAS,CACP,eAAgB,oBAElBoB,KAAMC,KAAKC,UAAUjD,EAAa+C,MAEpC,OAAOxB,EAAeC,IAGlB0B,EAAU9B,OACZ+B,gBACAnC,UAASM,WACXgB,EACAC,EAAgC,MAEhC,MAAMC,EAAK,IAAIC,gBACbzC,EAAauC,IACbG,WACIC,EAAMH,EAAK,GAAGlB,IAAUgB,KAAQE,IAAO,GAAGlB,IAAUgB,IACpDd,QAAYR,EAAQ2B,EAAK,CAC7BC,OAAQ,MACRjB,QAAS,CACPkB,OAAQ,mBACRO,cAAe,UAAUD,OAG7B,OAAO5B,EAAeC,UA2BX6B,EAKX,WAAAlD,CAAYmD,EAAuBC,GACjChD,KAAK+C,OAASA,EACd/C,KAAKgD,OAAS,IACTxC,KACAwC,GAELhD,KAAKiD,YAAc,IAAIC,IACzB,CAEA,eAAIN,GACF,OAAO5C,KAAK+C,OAAOH,WACrB,CACA,gBAAIO,GACF,OAAOnD,KAAK+C,OAAOI,YACrB,CACA,WAAIC,GACF,OAAOpD,KAAK+C,OAAOK,OACrB,CACA,aAAIC,GACF,OAAOrD,KAAK+C,OAAOM,SACrB,CACA,aAAIC,GACF,OAAOtD,KAAK+C,OAAOO,SACrB,CACA,iBAAIC,GACF,OAAOvD,KAAKiD,WACd,CACA,aAAIO,GACF,OAAO,IAAIN,KAAKlD,KAAKiD,YAAYQ,UAA6B,IAAjBzD,KAAKsD,UACpD,CAEA,SAAAI,GACE,OAAOR,KAAKS,OAAS3D,KAAKwD,UAAUC,UAlRtB,GAmRhB,CAQA,WAAM7C,CAAMwB,EAA6BwB,EAAoB,IAC3D,MAAMnD,QAAEA,GAAYT,KAAKgD,OAOzB,OAJIhD,KAAK0D,mBACD1D,KAAK6D,gBAGApD,EAAQ2B,EAAK,IACrBwB,EACHxC,QAAS,IACHwC,EAAKxC,SAAW,GACpByB,cAAe,UAAU7C,KAAK+C,OAAOH,gBAG3C,CAEA,aAAMiB,GACJ,MAAMpD,QAAEA,EAAOM,QAAEA,GAAYf,KAAKgD,OAC5B/B,QAAYR,EAAQ,GAAGM,iBAAwB,CACnDsB,OAAQ,OACRjB,QAAS,CACP,eAAgB,oBAElBoB,KAAMC,KAAKC,UACTjD,EAAa,CAAE0D,aAAcnD,KAAK+C,OAAOI,kBAGvC5B,QAAaP,EAAeC,GAClCjB,KAAK+C,OAASxB,EACdvB,KAAKiD,YAAc,IAAIC,IACzB,CAEA,2BAAMY,QAjGSjD,QACb+B,gBACAnC,UAASM,WACXgB,EACAS,KAEA,MAAMvB,QAAYR,EAAQ,GAAGM,IAAUgB,IAAQ,CAC7CM,OAAQ,OACRjB,QAAS,CACP,eAAgB,mBAChByB,cAAe,UAAUD,KAE3BJ,KAAMC,KAAKC,UAAUjD,EAAa+C,MAGpC,OAAOxB,EAAeC,IAmFd8C,CAAS/D,KAAMA,KAAKgD,OAAQ,gCAAiC,CAAA,EACrE,CAEA,QAAMgB,GACJ,aAAarB,EAAQ3C,KAAMA,KAAKgD,OAAQ,WAAY,GACtD,CAEA,UAAMiB,CAAKC,GACT,aAAavB,EAAQ3C,KAAMA,KAAKgD,OAAQ,cAAckB,IAAM,GAC9D,QAGWC,EAGX,WAAAvE,CAAYoD,GACVhD,KAAKoE,QAAU,IAAK5D,KAAkBwC,EACxC,CAEA,wBAAOqB,CACLtB,EACAC,GAEA,OAAO,IAAImB,EAAGnB,GAAQqB,kBAAkBtB,EAC1C,CAEA,iBAAAsB,CAAkBtB,GAChB,OAAO,IAAID,EAAYC,EAAQ/C,KAAKoE,QACtC,CAEA,yBAAaE,CACXtC,EAIAgB,GAEA,OAAO,IAAImB,EAAGnB,GAAQsB,aAAatC,EACrC,CAEA,kBAAMsC,CAAatC,GAIjB,aAAaF,EAAU9B,KAAKoE,QAAS,sBAAuBpC,EAC9D,CAEA,uBAAauC,CACX/B,EACAQ,GAMA,OAAO,IAAImB,EAAGnB,GAAQuB,WAAW/B,EACnC,CAEA,gBAAM+B,CAAW/B,GASf,OAAOD,EAAWvC,KAAKoE,QAAS,oBAAqB5B,EACvD,CAEA,wBAAagC,CACXxB,GAEA,OAAO,IAAImB,EAAGnB,GAAQwB,aACxB,CAEA,iBAAMA,GACJ,OAAO1C,EAAU9B,KAAKoE,QAAS,qBACjC,CAEA,sBAAaK,CACXzB,GAEA,OAAO,IAAImB,EAAGnB,GAAQyB,WACxB,CAEA,eAAMA,GACJ,OAAO3C,EAAU9B,KAAKoE,QAAS,mBACjC,CAEA,kBAAaM,CACXlC,EAKAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQ0B,MAAMlC,EAC9B,CAEA,WAAMkC,CAAMlC,GAKV,aAAaD,EAAWvC,KAAKoE,QAAS,cAAe5B,EACvD,CAEA,uBAAamC,CACXC,EACA5B,GAEA,OAAO,IAAImB,EAAGnB,GAAQ2B,WAAWC,EACnC,CAEA,gBAAMD,CAAWC,GACf,MAAMR,EAAUpE,KAAKoE,QACrB,aAAatC,EAAUsC,EAAS,oBAAqB,CACnDQ,SAEJ,CAEA,oBAAaf,CACXV,EACAH,GAEA,OAAO,IAAImB,EAAGnB,GAAQa,QAAQV,EAChC,CAEA,aAAMU,CAAQV,GACZ,aAAaZ,EAAWvC,KAAKoE,QAAS,gBAAiB,CACrDjB,gBAEJ,CAEA,qBAAa0B,CACXrC,EAKAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQ6B,SAASrC,EACjC,CAEA,cAAMqC,CAASrC,GAKb,aAAaD,EAAWvC,KAAKoE,QAAS,iBAAkB5B,EAC1D,CAEA,0BAAasC,CACXtC,EAIAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQ8B,cAActC,EACtC,CAEA,mBAAMsC,CAActC,GAIlB,OAAOD,EAAWvC,KAAKoE,QAAS,uBAAwB5B,EAC1D,CAEA,0BAAauC,CACXvC,EAIAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQ+B,cAAcvC,EACtC,CAEA,mBAAMuC,CAAcvC,GAIlB,OAAOD,EAAWvC,KAAKoE,QAAS,wBAAyB5B,EAC3D,CAEA,8BAAawC,CACXxC,EAIAQ,GAEA,OAAO,IAAImB,EAAGnB,GAAQgC,kBAAkBxC,EAC1C,CAEA,uBAAMwC,CAAkBxC,GAItB,OAAOD,EAAWvC,KAAKoE,QAAS,4BAA6B5B,EAC/D"}

package/dist/types/auth.d.ts

@@ -0,0 +1,134 @@
+import type { AuthenticationResult, ClientId, EmailCheckStatus, LoginMethod, ProblemDetails, SessionProfile, SessionTokens, UserId, UserResource } from "./types";
+type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export declare class AuthError extends Error {
+    readonly problem: ProblemDetails;
+    constructor(problem: ProblemDetails);
+    get type(): string;
+    get title(): string;
+    get status(): number;
+    get code(): string | undefined;
+    get detail(): string | undefined;
+    get invalidParams(): ProblemDetails["invalidParams"] | undefined;
+}
+type Config = {
+    fetchFn: FetchFn;
+    baseUrl: string;
+};
+export declare class AuthSession {
+    private tokens;
+    private config;
+    private lastUpdated;
+    constructor(tokens: SessionTokens, config: Partial<Config>);
+    get accessToken(): string;
+    get refreshToken(): string;
+    get idToken(): string | undefined;
+    get tokenType(): "Bearer";
+    get expiresIn(): number;
+    get lastUpdatedAt(): Date;
+    get expiresAt(): Date;
+    isExpired(): boolean;
+    /**
+     * Fetch with automatic token refresh.
+     *
+     * If the access token is expired, it will be refreshed before making the request. The
+     * Authorization header will be set with the current access token.
+     */
+    fetch(url: string | URL | Request, init?: RequestInit): Promise<Response>;
+    refresh(): Promise<void>;
+    sendVerificationEmail(): Promise<void>;
+    me(): Promise<SessionProfile>;
+    user(id: UserId): Promise<UserResource>;
+}
+export declare class Am {
+    private options;
+    constructor(config?: Partial<Config>);
+    static createAuthSession(tokens: SessionTokens, config?: Partial<Config>): AuthSession;
+    createAuthSession(tokens: SessionTokens): AuthSession;
+    static acceptInvite(query: {
+        clientId: ClientId;
+        token: string;
+    }, config?: Partial<Config>): Promise<AuthenticationResult>;
+    acceptInvite(query: {
+        clientId: ClientId;
+        token: string;
+    }): Promise<AuthenticationResult>;
+    static checkEmail(body: {
+        clientId: ClientId;
+        email: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<{
+        status: EmailCheckStatus;
+        preferred: LoginMethod[];
+        available: LoginMethod[];
+    }>;
+    checkEmail(body: {
+        clientId: ClientId;
+        email: string;
+        csrfToken?: string;
+    }): Promise<{
+        status: EmailCheckStatus;
+        preferred: LoginMethod[];
+        available: LoginMethod[];
+    }>;
+    static csrfSession(config?: Partial<Config>): Promise<{
+        csrfToken: string;
+    }>;
+    csrfSession(): Promise<{
+        csrfToken: string;
+    }>;
+    static csrfToken(config?: Partial<Config>): Promise<{
+        csrfToken: string;
+    }>;
+    csrfToken(): Promise<{
+        csrfToken: string;
+    }>;
+    static login(body: {
+        email: string;
+        password: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<AuthenticationResult>;
+    login(body: {
+        email: string;
+        password: string;
+        csrfToken?: string;
+    }): Promise<AuthenticationResult>;
+    static tokenLogin(token: string, config?: Partial<Config>): Promise<AuthenticationResult>;
+    tokenLogin(token: string): Promise<AuthenticationResult>;
+    static refresh(refreshToken: string, config?: Partial<Config>): Promise<SessionTokens>;
+    refresh(refreshToken: string): Promise<SessionTokens>;
+    static register(body: {
+        email: string;
+        password: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<AuthenticationResult>;
+    register(body: {
+        email: string;
+        password: string;
+        csrfToken?: string;
+    }): Promise<AuthenticationResult>;
+    static resetPassword(body: {
+        token: string;
+        newPassword: string;
+    }, config?: Partial<Config>): Promise<void>;
+    resetPassword(body: {
+        token: string;
+        newPassword: string;
+    }): Promise<void>;
+    static sendMagicLink(body: {
+        email: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<void>;
+    sendMagicLink(body: {
+        email: string;
+        csrfToken?: string;
+    }): Promise<void>;
+    static sendPasswordReset(body: {
+        email: string;
+        csrfToken?: string;
+    }, config?: Partial<Config>): Promise<void>;
+    sendPasswordReset(body: {
+        email: string;
+        csrfToken?: string;
+    }): Promise<void>;
+}
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export { Am, AuthSession, AuthError } from "./auth";
+export type { AuthenticationResult, ClientId, EmailCheckStatus, LoginMethod, ProblemDetails, SessionProfile, SessionTokens, UserId, UserResource, } from "./types";

package/dist/types/types.d.ts

@@ -0,0 +1,77 @@
+export type ProblemDetails = {
+    type: string;
+    title: string;
+    status: number;
+    code?: string;
+    detail?: string;
+    invalidParams?: {
+        in: "body" | "cookie" | "header" | "query" | "path";
+        path: string;
+        type: string;
+        received: unknown;
+        expected?: string;
+    }[];
+};
+export type ClientId = `cid${string}`;
+export type UserId = `uid${string}`;
+export type AccountId = `acc${string}`;
+export type MembershipId = `mbr${string}`;
+export type AccountStatus = "active" | "trial" | "past_due" | "suspended" | "closed";
+export type AccountResource = {
+    id: AccountId;
+    name: string | null;
+    avatarUrl: string | null;
+    status: AccountStatus;
+    paidUntil: string | null;
+};
+export type UserStatus = "active" | "trial" | "past_due" | "suspended" | "closed";
+export type UserResource = {
+    id: UserId;
+    accountId: AccountId;
+    status: UserStatus;
+    preferredMembershipId: MembershipId | null;
+};
+export type UserIdentity = {
+    id: UserId;
+    avatarUrl: string | null;
+    externalId: string | null;
+    givenName: string | null;
+    familyName: string | null;
+    displayName: string | null;
+    preferredLanguage: string | null;
+    locale: string | null;
+    timezone: string | null;
+};
+export type MembershipRole = "owner" | "member" | "viewer";
+export type Membership = {
+    id: MembershipId;
+    userId: UserId;
+    accountId: AccountId;
+    role: MembershipRole;
+};
+export type EmailCredential = {
+    id: string;
+    email: string | null;
+    hashedEmail: string | null;
+    hashedPassword: string | null;
+    emailVerifiedAt: string | null;
+};
+export type SessionTokens = {
+    accessToken: string;
+    refreshToken: string;
+    tokenType: "Bearer";
+    expiresIn: number;
+    idToken?: string;
+};
+export type SessionProfile = UserResource & {
+    identity: UserIdentity;
+    emailCredentials: EmailCredential[];
+    memberships: Membership[];
+    activeMembership: Membership | null;
+};
+export type AuthenticationResult = {
+    session: SessionTokens;
+    profile: SessionProfile;
+};
+export type EmailCheckStatus = "active" | "inactive";
+export type LoginMethod = "email_password" | "magic_link";

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@softwarepatterns/am",
+  "version": "0.0.1",
+  "description": "Auth client SDK for AccountMaker (Am)",
+  "keywords": [
+    "authentication",
+    "auth",
+    "sdk",
+    "typescript",
+    "oauth",
+    "openid-connect",
+    "jwt",
+    "session-management"
+  ],
+  "author": "Your Name <info@example.com>",
+  "license": "MIT",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/softwarepatterns/am/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/softwarepatterns/am.git"
+  },
+  "homepage": "https://github.com/softwarepatterns/am#readme",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build:clean": "rm -rf dist",
+    "build": "npm run build:clean && rollup -c",
+    "prepublishOnly": "npm run check",
+    "test:unit": "bun test src",
+    "test:integration": "NODE_TLS_REJECT_UNAUTHORIZED=0 bun test test/integration",
+    "typecheck": "bunx tsc --noEmit",
+    "check": "npm run typecheck && npm run build",
+    "digest": "bunx ai-digest -i . -o codebase.md --whitespace-removal --show-output-files"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}