@somewhere-cloud/sdk 0.0.0-stage → 0.13.0

package/dist/types/types.d.ts

@@ -0,0 +1,379 @@
+import type { SomewhereError } from './errors.js';
+import type { CacheOptions } from './query-cache.js';
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/**
+ * Client query-cache configuration. `from().select()` is cached by default.
+ * - omitted / `true` — on with defaults (~1s staleTime + request dedup).
+ * - `false` — off entirely; every read hits the network (pre-v0.5 semantics).
+ * - object — on, with the given {@link CacheOptions} (e.g. `{ staleTime }`).
+ */
+export type CacheConfig = boolean | CacheOptions;
+export interface SomewhereOptions {
+    /** Developer `smt_` API key. Mutually exclusive with `token`; omit for browser cookie auth. */
+    key?: string;
+    /** App-user JWT for bearer/compatibility mode. Mutually exclusive with `key`; omit for browser cookie auth. */
+    token?: string;
+    /** Default `project_id` used by every query/storage/auth/emails/chat call. */
+    projectId?: string;
+    /** Override the REST base URL. Defaults to `https://api.somewhere.cloud/v1`. */
+    baseUrl?: string;
+    /**
+     * The project's own URL (e.g. `https://my-app.somewhere.site`), used as the
+     * host for `functions.invoke(name)` → `{functionsUrl}/api/{name}`. Set
+     * automatically when you build the client with `createClient(url, key)`.
+     * When omitted, `functions.invoke` returns NO_FUNCTION_HOST without a request;
+     * it never derives a host from `projectId`.
+     */
+    functionsUrl?: string;
+    /** Inject a custom fetch implementation (tests, polyfills). */
+    fetch?: FetchLike;
+    /** Extra headers to attach to every request. */
+    headers?: Record<string, string>;
+    /**
+     * Session transport for `auth.*`.
+     *
+     * - `'cookie'` (the BROWSER default) — sign-in goes through your app's own
+     *   backend auth routes (same origin, `authPath`), which set the session as
+     *   httpOnly cookies. No token ever lands in JS or localStorage — XSS can't
+     *   steal what the page can't read. Requires the standard backend handler
+     *   (`sw.auth.loginWithCookie` et al) mounted at `authPath`.
+     * - `'header'` (the default outside browsers, where httpOnly cookies don't
+     *   exist) — tokens held in SDK memory, `Authorization: Bearer` transport.
+     *   This is also the advanced/manual mode for native apps.
+     */
+    authMode?: 'cookie' | 'header';
+    /** Path your backend auth routes are mounted at (cookie mode). Default '/api/auth'. */
+    authPath?: string;
+    /**
+     * Client query cache for `from().select()`. On by default (~1s staleTime +
+     * request dedup + invalidate-on-write). Pass `false` to disable. See
+     * {@link CacheConfig}.
+     */
+    cache?: CacheConfig;
+}
+/**
+ * Options for the `createClient(url, key, options?)` factory.
+ */
+export interface CreateClientOptions {
+    /**
+     * Explicit project id, slug, or subdomain. Overrides the value derived
+     * from the URL's subdomain. **Required when the URL is a custom domain**
+     * (e.g. `https://myapp.com`) — we can't infer the project from it.
+     */
+    projectId?: string;
+    /** Override the platform REST base. Defaults to `https://api.somewhere.cloud/v1`. */
+    apiUrl?: string;
+    /** Override the functions host. Defaults to the URL passed as the first argument. */
+    functionsUrl?: string;
+    /** Inject a custom fetch implementation (tests, non-browser runtimes). */
+    fetch?: FetchLike;
+    /** Extra headers attached to every platform request. */
+    headers?: Record<string, string>;
+    /** Session transport for `auth.*` — see SomewhereOptions.authMode. Default: 'cookie' in browsers, 'header' elsewhere. */
+    authMode?: 'cookie' | 'header';
+    /** Path your backend auth routes are mounted at (cookie mode). Default '/api/auth'. */
+    authPath?: string;
+    /**
+     * Client query cache for `from().select()`. On by default. Pass `false` to
+     * disable, or an object to tune (e.g. `{ staleTime: 2000 }`). See
+     * {@link CacheConfig}.
+     */
+    cache?: CacheConfig;
+}
+/** Options for `functions.invoke(name, options)`. */
+export interface FunctionInvokeOptions {
+    /** Request body. Objects/arrays are JSON-encoded; strings/binary pass through. */
+    body?: unknown;
+    /** Extra request headers. */
+    headers?: Record<string, string>;
+    /** HTTP method. Defaults to `POST`. */
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+}
+/**
+ * Auth state-change events, used by `onAuthStateChange` callbacks.
+ */
+export type AuthChangeEvent = 'INITIAL_SESSION' | 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED' | 'USER_UPDATED';
+/** Handle returned by `auth.onAuthStateChange` — call `unsubscribe()` to detach. */
+export interface AuthSubscription {
+    data: {
+        subscription: {
+            unsubscribe: () => void;
+        };
+    };
+}
+/**
+ * Every mutating call (db, storage, auth, emails) returns this shape.
+ * `error` is null on success, and
+ * `data` is null on error. Callers never throw-catch — they branch on
+ * the error field.
+ *
+ * The one exception is `sw.chat.completions.create(...)` which throws,
+ * matching the OpenAI SDK.
+ */
+export interface Result<T> {
+    data: T | null;
+    error: SomewhereError | null;
+    count?: number | null;
+    status?: number;
+}
+export interface User {
+    id: string;
+    email: string;
+    display_name?: string | null;
+    metadata?: Record<string, unknown> | null;
+    email_verified?: boolean;
+    created_at: string;
+    [k: string]: unknown;
+}
+export interface Session {
+    /**
+     * The user's JWT — present in header mode only. A cookie session
+     * (`cookie_session: true`) deliberately has NO readable tokens: they live
+     * in httpOnly cookies the browser owns, invisible to JS by design.
+     */
+    access_token?: string;
+    /** Long-lived (30d) opaque refresh token. Use `auth.refreshSession()` to mint a new pair. */
+    refresh_token?: string;
+    /** Server-side session id; pass to `auth.signOut()` to revoke. */
+    session_token?: string;
+    /** Seconds until `access_token` expires. */
+    expires_in?: number;
+    /** True when the session is held as httpOnly cookies (browser default). */
+    cookie_session?: boolean;
+    user: User;
+}
+export interface AuthResponse {
+    user: User | null;
+    session: Session | null;
+}
+export interface StorageFileObject {
+    name: string;
+    id?: string;
+    bucket?: string;
+    /** Bytes. */
+    size: number;
+    /** RFC-3339 timestamp. */
+    updated_at?: string;
+    /** Content type as stored on upload. */
+    content_type?: string;
+}
+export interface StorageUploadResult {
+    path: string;
+    fullPath: string;
+    id: string;
+}
+export interface StorageDownloadResult {
+    body: ArrayBuffer;
+    contentType: string;
+}
+export interface SignedUrlResult {
+    url: string;
+    token: string;
+    path: string;
+    expires_at: string;
+    expires_in: number;
+}
+export interface IntegrityCheckResult {
+    scanned: number;
+    orphan_files: Array<{
+        id: string;
+        path: string;
+        r2_key: string;
+    }>;
+    orphan_versions: Array<{
+        id: string;
+        file_id: string;
+        version: number;
+        r2_key: string;
+    }>;
+    auto_clean: boolean;
+    cleaned: {
+        files: number;
+        versions: number;
+    };
+    next_cursor: string | null;
+}
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    max_tokens?: number;
+    temperature?: number;
+    system?: string;
+    /** Provider override — defaults to anthropic on the platform. */
+    provider?: string;
+}
+export interface ChatCompletion {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: ChatMessage;
+        finish_reason: 'stop' | 'length' | 'content_filter' | 'tool_calls';
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface SendEmailRequest {
+    from: string;
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    reply_to?: string | string[];
+    cc?: string | string[];
+    bcc?: string | string[];
+}
+export interface SendEmailResponse {
+    id: string;
+}
+export interface PaymentsOnboardRequest {
+    /** Defaults to the client's default project. */
+    projectId?: string;
+    /** Where Stripe sends the user after the hosted onboarding completes. */
+    return_url?: string;
+    /** Where Stripe sends the user if the link expires before completion. */
+    refresh_url?: string;
+}
+export interface PaymentsOnboardResponse {
+    account_id: string;
+    onboarding_url: string;
+    /** RFC-3339 timestamp. The hosted link expires after a short window. */
+    expires_at: string;
+}
+export interface PaymentsStatusOptions {
+    projectId?: string;
+    /** When true, re-fetches state from upstream — slower but reconciles after onboarding return. */
+    refresh?: boolean;
+}
+export interface PaymentsStatusResponse {
+    connected: boolean;
+    account_id?: string;
+    onboarded: boolean;
+    charges_enabled: boolean;
+    payouts_enabled: boolean;
+    details_submitted?: boolean;
+    country?: string | null;
+    default_currency?: string | null;
+}
+export interface CheckoutLineItem {
+    /** Existing Stripe price id on the connected account. Mutually exclusive with the inline form. */
+    price?: string;
+    /** Inline amount in the smallest currency unit (cents). Pair with currency + name. */
+    amount?: number;
+    currency?: string;
+    name?: string;
+    quantity?: number;
+}
+export interface PaymentsCheckoutRequest {
+    projectId?: string;
+    line_items: CheckoutLineItem[];
+    mode?: 'payment' | 'subscription';
+    success_url: string;
+    cancel_url: string;
+    customer_email?: string;
+    metadata?: Record<string, string>;
+}
+export interface PaymentsCheckoutResponse {
+    session_id: string;
+    url: string;
+    amount_total_cents: number;
+    platform_fee_cents: number;
+    fee_percent: number;
+}
+export interface PaymentsDashboardLinkResponse {
+    url: string;
+}
+export interface VideoUploadUrlRequest {
+    projectId?: string;
+    title?: string;
+    /** Caps the longest video the upload URL will accept. Clamped 30–21600s. */
+    max_duration_seconds?: number;
+    require_signed_urls?: boolean;
+}
+export interface VideoUploadUrlResponse {
+    video_id: string;
+    upload_url: string;
+    max_duration_seconds: number;
+}
+export interface VideoObject {
+    id: string;
+    project_id: string;
+    title: string | null;
+    ready: boolean;
+    status: string;
+    size_bytes: number;
+    duration_seconds: number;
+    thumbnail: string;
+    preview: string;
+    hls_url: string;
+    dash_url: string;
+    /** RFC-3339 timestamp. */
+    created_at: string;
+    /** RFC-3339 timestamp. */
+    modified_at: string;
+}
+export interface VideoListResponse {
+    videos: VideoObject[];
+    count: number;
+}
+export interface InboxAddressCreateRequest {
+    projectId?: string;
+    /** Local-part only. The platform adds the inbox.{platform-domain} suffix. */
+    local: string;
+    label?: string;
+}
+export interface InboxAddress {
+    id: string;
+    project_id: string;
+    address: string;
+    label: string | null;
+    /** RFC-3339 timestamp. */
+    created_at: string;
+}
+export interface InboxAddressListResponse {
+    addresses: InboxAddress[];
+}
+export interface InboxMessageSummary {
+    id: string;
+    address_id: string;
+    project_id: string;
+    mail_from: string;
+    mail_to: string;
+    subject: string | null;
+    text_preview: string | null;
+    size_bytes: number;
+    /** RFC-3339 timestamp. */
+    received_at: string;
+}
+export interface InboxMessageListResponse {
+    messages: InboxMessageSummary[];
+    count: number;
+}
+export interface InboxMessageDetail extends InboxMessageSummary {
+    r2_key: string;
+    /** Sub-path on the API base URL that returns the raw .eml bytes. */
+    raw_url: string;
+}
+export interface InboxListOptions {
+    projectId?: string;
+    addressId?: string;
+    limit?: number;
+}
+export interface CallsSessionCreateRequest {
+    projectId?: string;
+    thirdparty?: boolean;
+}
+export interface CallsSessionCreateResponse {
+    session_id: string;
+    project_id: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,88 @@
 {
   "name": "@somewhere-cloud/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.13.0",
+  "description": "Official JavaScript/TypeScript SDK for the somewhere.cloud platform API.",
+  "keywords": [
+    "somewhere",
+    "somewhere.cloud",
+    "backend",
+    "sdk",
+    "database",
+    "auth",
+    "storage",
+    "ai",
+    "functions"
+  ],
+  "homepage": "https://somewhere.cloud",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Somewhere-Cloud/somewhere-sdk-js.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "somewhere.cloud",
+    "email": "support@somewhere.cloud"
+  },
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    },
+    "./auth": {
+      "types": "./dist/types/auth/index.d.ts",
+      "import": "./dist/esm/auth/index.js",
+      "require": "./dist/cjs/auth/index.js"
+    },
+    "./react": {
+      "types": "./dist/types/auth/react.d.ts",
+      "import": "./dist/esm/auth/react.js",
+      "require": "./dist/cjs/auth/react.js"
+    },
+    "./server": {
+      "types": "./dist/types/auth/server.d.ts",
+      "import": "./dist/esm/auth/server.js",
+      "require": "./dist/cjs/auth/server.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json && node -e \"require('fs').writeFileSync('dist/esm/package.json','{\\\"type\\\":\\\"module\\\"}')\"",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json','{\\\"type\\\":\\\"commonjs\\\"}')\" && node -e \"require('fs').renameSync('dist/cjs/index.js','dist/cjs/index.cjs')\"",
+    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "test": "npm run build && tsc -p tsconfig.test.json && node test/unit-supabase-shape.mjs && node test/unit-query-builder.mjs && node test/unit-cookie-auth.mjs && node test/unit-cookie-default.mjs && node test/unit-auth-adapter-contract.mjs && node test/unit-mfa-continuation.mjs && node test/unit-signin-hardening.mjs && node test/unit-portable-refresh.mjs && node test/unit-refresh-reconcile.mjs && node test/unit-refresh-outcome-unknown.mjs && node test/unit-valid-token-during-refresh.mjs && node test/unit-session-status.mjs && node test/unit-signout-body.mjs && node test/unit-header-logout.mjs && node test/unit-cookie-logout.mjs && node test/unit-email-verification.mjs && node test/unit-oauth-start.mjs && node test/unit-cache.mjs && node test/unit-cache.mjs --built && node test/unit-function-retry.mjs && node test/unit-invalid-response.mjs && node test/unit-cloud-default.mjs && node test/unit-function-host.mjs && node test/unit-explicit-billing.mjs && node test/unit-react-explicit-billing.mjs && node test/unit-db-query.mjs && node test/unit-projects.mjs && node test/unit-project-update.mjs && node --input-type=module -e \"import('./dist/esm/index.js').then(async (m) => { globalThis.__sw = m; await import('./test/run-basic.mjs'); })\"",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test:browser-signout": "node test/browser-signout-reload.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.2.16",
+    "@types/react-dom": "19.3.0",
+    "esbuild": "0.28.2",
+    "playwright": "1.58.2",
+    "react": "^19.2.0",
+    "react-dom": "19.2.8",
+    "typescript": "^5.4.0"
+  }
+}