@stable_sea/sdk 0.2.11 → 0.2.12

package/README.md

@@ -53,6 +53,42 @@ keys and rotations reuse that data.
 WTGXX supports standard and instant settlement. FLTTX supports standard
 settlement; instant orders are refused in both production and sandbox.
 
+## Member notifications and support
+
+Use `createStableSeaSessionClient` for personal notifications, preferences and
+business support messages. It uses an existing signed-in business session,
+not a Live or Test API key. Use `https://api.stablesea.com`; the isolated
+Test-key Sandbox does not serve member sessions.
+
+```ts
+import { createStableSeaSessionClient } from "@stable_sea/sdk";
+
+// authenticatedFetch is your transport retaining the existing sign-in cookies.
+const member = createStableSeaSessionClient({
+  baseUrl: "https://api.stablesea.com",
+  fetch: authenticatedFetch,
+});
+const feed = await member.GET("/notifications/member_notifications");
+if (feed.error) throw new Error("Could not read notifications");
+console.log(feed.data.data);
+```
+
+Node.js fetch does not retain cookies automatically. Supply your authenticated
+transport; the client does not implement login, refresh or automatic retries.
+Existing login MFA, business membership, locks and permissions remain in force.
+Member requests do not use the dated financial API contract header.
+
+Member writes use `member.POST`, with each native operation's retry behavior.
+They have no financial `mutation()` helper or idempotency-key replay. After an
+uncertain message send, match the returned `id` in the thread against the
+`message_id` you sent before resending;
+repeated sends can repeat notifications. Contact submissions must not retry
+automatically. See the [member guide](https://docs.stablesea.com/api/#member-sessions)
+for sign-in, session lifecycle and attachment retrieval, and the
+[member reference](https://docs.stablesea.com/api/member-reference/) for fields.
+Generated types are exported as `SessionPaths`, `SessionOperations` and
+`SessionComponents`; internal operator and excluded product operations are omitted.
+
 ## Idempotent writes
 
 Create one mutation handle for one logical write. Its `POST` method always sends

package/dist/gen/session-schema.d.ts

@@ -0,0 +1,1027 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/compliance/documents/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve a document
+         * @description Returns a document owned by your current business, including its filename, media type and base64-encoded content. Use the document ID from a message attachment. Missing documents and documents owned by another business return 404.
+         */
+        get: operations["compliance.documents.download"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/compliance/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List business messages
+         * @description Returns the current business’s support and compliance messages, newest first. Message text is base64-encoded in `content_text_b64`. Retrieve attachments using their `document_id`. Pass `next_cursor` as `cursor` to read older messages; a cursor is valid only for the business that issued it.
+         */
+        get: operations["compliance.messages.list"];
+        put?: never;
+        /**
+         * Send a business message
+         * @description Sends a support or compliance message as the signed-in member of the current business. Supply a new `message_id` for each message. After an uncertain response, check the message list for that ID before retrying. Repeated sends can repeat support notifications; this operation does not provide idempotency-key replay. Optional `content_docs` carry base64-encoded attachments. A successful response acknowledges storage; it does not confirm that support has read the message.
+         */
+        post: operations["compliance.messages.send"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/compliance/messages/read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark business messages read
+         * @description Marks the current business thread read for the signed-in member through its latest message. Messages arriving later remain unread. Other members’ read state is unchanged.
+         */
+        post: operations["compliance.messages.read"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/compliance/messages/unread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Count your unread business messages
+         * @description Counts messages from other people in the current business thread since you last marked it read. Your own messages do not increase the count.
+         */
+        get: operations["compliance.messages.unread.get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/misc/contact_us": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Contact support
+         * @description Records your contact request and sends it to support. Requires a signed-in business session. This submission has no idempotency key: do not automatically retry an uncertain response, because it can send another email.
+         */
+        post: operations["misc.contact.submit"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/notifications/member_notifications": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List your notifications
+         * @description Returns your supported notifications for the current business, newest first. Use next_cursor for the following page. Includes registered notification types except QuickBooks. Requires a signed-in business session; account and member locks still apply.
+         */
+        get: operations["notifications.member_notifications.list"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/notifications/member_notifications/mark_seen": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark your feed seen
+         * @description Marks supported notifications seen for your current business. Other businesses, people and excluded product categories are unchanged. Requires a signed-in business session.
+         */
+        post: operations["notifications.member_notifications.mark_seen"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/notifications/member_notifications/unseen": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Count your unseen notifications
+         * @description Counts unseen, unarchived notifications in your supported feed for the current business. Requires a signed-in business session.
+         */
+        get: operations["notifications.member_notifications.unseen"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/notifications/member_notifications/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Update a notification
+         * @description Marks one of your notifications seen, archived or restored and returns its updated state. Send seen=true or an archived flag; omitted fields stay unchanged. Notifications outside your current business or supported feed return 404. Requires a signed-in business session.
+         */
+        post: operations["notifications.member_notifications.update"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/notifications/member_preferences": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get your notification preferences
+         * @description Returns your supported email and desktop preferences for the current business. Security and other mandatory notices cannot be disabled. Requires a signed-in business session.
+         */
+        get: operations["notifications.member_preferences.get"];
+        put?: never;
+        /**
+         * Update your notification preferences
+         * @description Updates your supplied email or desktop preferences for the current business and returns the supported preference list. Omitted channels stay unchanged. Mandatory notices and unsupported categories cannot be changed. Requires a signed-in business session.
+         */
+        post: operations["notifications.member_preferences.update"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        DocumentsDownloadB64Output: {
+            content_b64?: string;
+            filename?: string;
+            mime_type?: string;
+        };
+        HttputilAPIError: {
+            error?: components["schemas"]["HttputilAPIErrorBody"];
+        };
+        HttputilAPIErrorBody: {
+            /** @description Legal values/transitions on an illegal-transition conflict. */
+            allowed?: string[];
+            /** @description Credential ID issued by a duplicate credential-mint request. */
+            api_client_id?: string;
+            /** @description Stable machine-readable error code when supplied; use error.type for uncoded errors. */
+            code?: string;
+            /** @description Per-field validation breakdown. */
+            errors?: components["schemas"]["HttputilAPIFieldError"][];
+            /** @description Human-readable explanation. Use code or type for programmatic handling. */
+            message?: string;
+            /** @description RFC 6901 JSON Pointer to the first offending field, on a validation error or a coded error about one field. */
+            param?: string;
+            /** @description Correlates with the Request-Id response header. */
+            request_id?: string;
+            /**
+             * @description Error class. One of a closed enum.
+             * @enum {string}
+             */
+            type?: "invalid_request_error" | "authentication_error" | "permission_error" | "idempotency_error" | "rate_limit_error" | "api_error";
+        };
+        HttputilAPIFieldError: {
+            /** @description Field-level error code. */
+            code?: string;
+            /** @description Human-readable detail for this field. */
+            detail?: string;
+            /** @description RFC 6901 JSON Pointer to the offending field. */
+            pointer?: string;
+        };
+        Page_MessagesView: {
+            data: components["schemas"]["MessagesView"][] | null;
+            has_more: boolean;
+            next_cursor: string | null;
+            total_count?: number | null;
+        };
+        MessagesView: {
+            content_doc_ids?: string[];
+            content_docs?: components["schemas"]["MessagesContentDoc"][];
+            content_text_b64?: string;
+            created_by?: string;
+            /** Format: date-time */
+            created_ts?: string;
+            group_id?: string;
+            id?: string;
+        };
+        MessagesContentDoc: {
+            document_id?: string;
+            file_name?: string;
+            /** Format: int64 */
+            file_size?: number;
+            file_type?: string;
+        };
+        MessagesSendBusinessInput: {
+            body?: string;
+            content_docs?: components["schemas"]["MessagesSendInputContent"][];
+            message_id: string;
+        };
+        MessagesSendInputContent: {
+            document_id: string;
+            file_contents_b64: string;
+            file_name: string;
+            /** Format: int64 */
+            file_size?: number;
+            file_type?: string;
+        };
+        MessagesAck: {
+            ok?: boolean;
+        };
+        MessagesUnreadCountOutput: {
+            /** Format: int64 */
+            count?: number;
+        };
+        MiscContactUsInput: {
+            email?: string;
+            message?: string;
+            name?: string;
+            subject?: string;
+        };
+        MiscAck: {
+            ok?: boolean;
+        };
+        Page_InappNotificationView: {
+            data: components["schemas"]["InappNotificationView"][] | null;
+            has_more: boolean;
+            next_cursor: string | null;
+            total_count?: number | null;
+        };
+        InappNotificationView: {
+            amount_display?: string;
+            archived?: boolean;
+            body?: string;
+            /** Format: date-time */
+            created_ts?: string;
+            group_id?: string;
+            id?: string;
+            individual_id?: string;
+            link?: string;
+            notification_type?: string;
+            seen?: boolean;
+            title?: string;
+        };
+        InappAck: {
+            ok?: boolean;
+        };
+        InappUnseenCountOutput: {
+            /** Format: int64 */
+            count?: number;
+        };
+        InappMemberUpdateInput: {
+            /** @description Set to true to archive or false to restore. Omission preserves its state. */
+            archived?: boolean;
+            /** @description Set to true to mark the notification seen. Omission preserves its state. */
+            seen?: boolean;
+        };
+        PreferencesGetPreferencesOutput: {
+            data?: components["schemas"]["PreferencesView"][] | null;
+        };
+        PreferencesView: {
+            channels?: components["schemas"]["PreferencesChannelStates"];
+            type?: string;
+        };
+        PreferencesChannelStates: {
+            desktop?: boolean;
+            email?: boolean;
+        };
+        PreferencesSetPreferencesInput: {
+            preferences: components["schemas"]["PreferencesTypePreferenceUpdate"][] | null;
+        };
+        PreferencesTypePreferenceUpdate: {
+            channels?: components["schemas"]["PreferencesChannelUpdate"];
+            type: string;
+        };
+        PreferencesChannelUpdate: {
+            desktop?: boolean | null;
+            email?: boolean | null;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    "compliance.documents.download": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DocumentsDownloadB64Output"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "compliance.messages.list": {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Page_MessagesView"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "compliance.messages.send": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["MessagesSendBusinessInput"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessagesAck"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "compliance.messages.read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessagesAck"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "compliance.messages.unread.get": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MessagesUnreadCountOutput"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "misc.contact.submit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["MiscContactUsInput"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MiscAck"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "notifications.member_notifications.list": {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+                seen?: boolean;
+                archived?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Page_InappNotificationView"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "notifications.member_notifications.mark_seen": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InappAck"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "notifications.member_notifications.unseen": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InappUnseenCountOutput"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "notifications.member_notifications.update": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["InappMemberUpdateInput"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InappNotificationView"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "notifications.member_preferences.get": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PreferencesGetPreferencesOutput"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+    "notifications.member_preferences.update": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["PreferencesSetPreferencesInput"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PreferencesGetPreferencesOutput"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HttputilAPIError"];
+                };
+            };
+        };
+    };
+}

package/dist/index.d.ts

@@ -2,3 +2,5 @@ export { createStableSeaClient, type StableSeaClient, type StableSeaMutation, ty
 export type { StableSeaClientOptions } from "./client.js";
 export type { components, operations, paths } from "./gen/schema.js";
 export { verifyWebhookSignature, type VerifyWebhookSignatureOptions, } from "./webhooks.js";
+export { createStableSeaSessionClient, type StableSeaSessionClient, type StableSeaSessionClientOptions, } from "./session-client.js";
+export type { components as SessionComponents, operations as SessionOperations, paths as SessionPaths, } from "./gen/session-schema.js";

package/dist/index.js

@@ -1,2 +1,3 @@
 export { createStableSeaClient, } from "./client.js";
 export { verifyWebhookSignature, } from "./webhooks.js";
+export { createStableSeaSessionClient, } from "./session-client.js";

package/dist/session-client.d.ts

@@ -0,0 +1,10 @@
+import createClient, { type ClientOptions } from "openapi-fetch";
+import type { paths } from "./gen/session-schema.js";
+export interface StableSeaSessionClientOptions {
+    baseUrl: string;
+    deviceId?: string;
+    fetch?: ClientOptions["fetch"];
+}
+export type StableSeaSessionClient = ReturnType<typeof createClient<paths>>;
+/** Customer member operations use an existing user session, never an API key. */
+export declare function createStableSeaSessionClient(options: StableSeaSessionClientOptions): StableSeaSessionClient;

package/dist/session-client.js

@@ -0,0 +1,12 @@
+import createClient, {} from "openapi-fetch";
+/** Customer member operations use an existing user session, never an API key. */
+export function createStableSeaSessionClient(options) {
+    if (!options.baseUrl)
+        throw new Error("baseUrl is required");
+    return createClient({
+        baseUrl: options.baseUrl,
+        credentials: "include",
+        fetch: options.fetch,
+        headers: options.deviceId ? { "X-Device-Id": options.deviceId } : undefined,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable_sea/sdk",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "type": "module",
   "sideEffects": false,
   "files": [
@@ -21,7 +21,7 @@
   },
   "repository": "git+https://github.com/StableSea/monorepo.git",
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.build.json && mkdir -p dist/gen && cp -f src/gen/schema.d.ts dist/gen/schema.d.ts",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && mkdir -p dist/gen && cp src/gen/schema.d.ts src/gen/session-schema.d.ts dist/gen/",
     "generate": "bash scripts/generate.sh",
     "prepack": "npm run build",
     "test": "npm run build && npm run test:unit && npm run test:consumer",