@mootup/moot-sdk 0.1.0-rc.0

package/README.md

@@ -0,0 +1,82 @@
+# @mootup/moot-sdk
+
+Typed HTTP client for the [convo](https://mootup.io) API, generated from
+OpenAPI 3.1 at build time. Runtime wrapper is ~6 KB on top of
+[`openapi-fetch`](https://openapi-ts.dev/openapi-fetch/).
+
+## Install
+
+```bash
+npm install @mootup/moot-sdk
+```
+
+Requires Node 20+ (native `fetch`).
+
+## Usage
+
+```ts
+import { createMootupClient } from '@mootup/moot-sdk';
+
+const client = createMootupClient({
+  baseUrl: 'https://mootup.io',
+  apiKey: process.env.MOOTUP_API_KEY, // optional; adds `Authorization: Bearer <key>`
+});
+
+const { data, error, response } = await client.GET('/health');
+if (error) {
+  throw new Error(`health check failed: ${response.status}`);
+}
+// `data` is typed from the OAS schema.
+```
+
+### Auth via session cookie (Node only)
+
+The `/auth/request` → `/api/actors/me` flow uses an HTTP-only session cookie.
+Browsers manage cookies natively, but in Node you must opt in:
+
+```ts
+const client = createMootupClient({
+  baseUrl: 'https://mootup.io',
+  persistCookies: true, // enable tough-cookie jar for Node
+});
+
+await client.POST('/auth/request', { body: { email: 'me@example.com' } });
+const me = await client.GET('/api/actors/me');
+```
+
+### Custom fetch
+
+```ts
+const client = createMootupClient({
+  baseUrl: 'https://mootup.io',
+  fetch: myInstrumentedFetch,
+});
+```
+
+## Response types
+
+At present, convo's OpenAPI spec declares `additionalProperties: true` on
+every response schema, so response bodies from this SDK arrive typed as
+`unknown` / `Record<string, unknown>`. If you need stronger types, cast at
+the call site or plug in a runtime validator (e.g. `zod`, `valibot`). See
+convo F-1 for the upstream fix.
+
+## Regenerating types
+
+`src/generated/paths.ts` is committed. To refresh after the convo OAS
+changes:
+
+```bash
+# 1. pull in the latest OAS from a sibling convo checkout
+npm run sync:oas
+
+# 2. regenerate TypeScript types
+npm run -w @mootup/moot-sdk generate
+
+# 3. rebuild
+npm run build
+```
+
+## License
+
+MIT.

package/dist/client.d.ts

@@ -0,0 +1,11 @@
+import type { paths } from './generated/paths.js';
+export interface MootupClientOptions {
+    baseUrl: string;
+    apiKey?: string;
+    fetch?: typeof globalThis.fetch;
+    persistCookies?: boolean;
+}
+export type MootupClient = ReturnType<typeof createMootupClient>;
+export declare function createMootupClient(opts: MootupClientOptions): import("openapi-fetch").Client<paths, `${string}/${string}`>;
+export type { paths, components, operations } from './generated/paths.js';
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAGlD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,gEAqB3D;AAED,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/client.js

@@ -0,0 +1,22 @@
+import createClient from 'openapi-fetch';
+import { makeCookieJarMiddleware } from './cookies.js';
+export function createMootupClient(opts) {
+    const client = createClient({
+        baseUrl: opts.baseUrl,
+        fetch: opts.fetch,
+    });
+    if (opts.apiKey) {
+        const token = opts.apiKey;
+        client.use({
+            async onRequest({ request }) {
+                request.headers.set('Authorization', `Bearer ${token}`);
+                return request;
+            },
+        });
+    }
+    if (opts.persistCookies) {
+        client.use(makeCookieJarMiddleware());
+    }
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAWvD,MAAM,UAAU,kBAAkB,CAAC,IAAyB;IAC1D,MAAM,MAAM,GAAG,YAAY,CAAQ;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC;YACT,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;gBACzB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;gBACxD,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cookies.d.ts

@@ -0,0 +1,10 @@
+import { CookieJar } from 'tough-cookie';
+import type { Middleware } from 'openapi-fetch';
+/**
+ * Build an openapi-fetch middleware that persists Set-Cookie headers across
+ * requests using an in-memory tough-cookie jar. Used by the /auth/request →
+ * /api/actors/me session flow in Node environments (browsers handle cookies
+ * natively).
+ */
+export declare function makeCookieJarMiddleware(jar?: CookieJar): Middleware;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../src/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,YAAkB,GAAG,UAAU,CAmBzE"}

package/dist/cookies.js

@@ -0,0 +1,35 @@
+import { CookieJar } from 'tough-cookie';
+/**
+ * Build an openapi-fetch middleware that persists Set-Cookie headers across
+ * requests using an in-memory tough-cookie jar. Used by the /auth/request →
+ * /api/actors/me session flow in Node environments (browsers handle cookies
+ * natively).
+ */
+export function makeCookieJarMiddleware(jar = new CookieJar()) {
+    return {
+        async onRequest({ request }) {
+            const cookieHeader = await jar.getCookieString(request.url);
+            if (cookieHeader) {
+                request.headers.set('Cookie', cookieHeader);
+            }
+            return request;
+        },
+        async onResponse({ response, request }) {
+            const setCookie = response.headers.get('set-cookie');
+            if (setCookie) {
+                for (const cookie of splitSetCookieHeader(setCookie)) {
+                    await jar.setCookie(cookie, request.url);
+                }
+            }
+            return response;
+        },
+    };
+}
+function splitSetCookieHeader(value) {
+    // Set-Cookie values can include commas inside expires/date attributes,
+    // which is why most stdlibs expose the raw header array separately. Node's
+    // fetch flattens to a single string. Split on commas that are followed by
+    // a cookie-attribute-looking prefix (word chars + '=').
+    return value.split(/,(?=\s*[A-Za-z0-9_-]+=)/);
+}
+//# sourceMappingURL=cookies.js.map

package/dist/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../src/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAG,GAAG,IAAI,SAAS,EAAE;IAC3D,OAAO;QACL,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;YACzB,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5D,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE;YACpC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,SAAS,EAAE,CAAC;gBACd,KAAK,MAAM,MAAM,IAAI,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;oBACrD,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,uEAAuE;IACvE,2EAA2E;IAC3E,0EAA0E;IAC1E,wDAAwD;IACxD,OAAO,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAChD,CAAC"}