@motherbase/client 1.5.0 → 1.5.1

package/dist/cookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../src/cookie.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAiB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAM9B;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AA4BD,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAcpE;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACjC,GAAG,qBAAqB,CA0B7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,GAAG,SAAc,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,qBAAqB,CAyCvB"}

package/dist/cookie.js

@@ -0,0 +1,152 @@
+import { memoryStorage, SESSION_COOKIE_KEY } from './session.js';
+/**
+ * The cookie the session is stored in. Re-exported here because both halves of
+ * an SSR setup have to agree on it: the browser writes it, the server reads it,
+ * and a key that matches on only one side looks exactly like "logged out".
+ */
+export { SESSION_COOKIE_KEY };
+const DEFAULT_KEY = SESSION_COOKIE_KEY;
+let warnedAboutCookieWrite = false;
+/**
+ * `process` is not declared in this package's lib (it targets the browser), so
+ * read it off `globalThis` rather than pulling in @types/node for one check.
+ * @internal
+ */
+export function isProduction() {
+    const proc = globalThis.process;
+    return proc?.env?.NODE_ENV === 'production';
+}
+/**
+ * The single most expensive failure in an SSR setup is silent: the session
+ * cookie is never written, so `getUser()`/`getSession()` return null everywhere
+ * and no Authorization header is ever attached, with nothing in the logs.
+ *
+ * It happens because Next.js forbids writing cookies from a Server Component,
+ * and the documented adapter shape swallows that failure in its own try/catch.
+ * The cookie has to be written from middleware instead, which is what
+ * `updateSession` from `@motherbase/ssr` is for. Say so, once, in development.
+ */
+function warnSessionCookieUnwritable(reason) {
+    if (warnedAboutCookieWrite)
+        return;
+    if (isProduction())
+        return;
+    warnedAboutCookieWrite = true;
+    console.warn(`[motherbase] The session cookie could not be written (${reason}). Server Components cannot `
+        + 'set cookies, so the session has to be refreshed in middleware: call `updateSession` from '
+        + '`@motherbase/ssr` in `proxy.ts` (Next.js 16+) or `middleware.ts` (Next.js 14/15). Until '
+        + 'then auth.getUser() and auth.getSession() return null on every request.');
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** @internal exported for tests; not part of the package's public surface. */
+export function parseSession(raw) {
+    if (!raw)
+        return null;
+    // Server adapters (Next's `cookies()`) hand back an already-decoded value;
+    // `document.cookie` hands back the percent-encoded one. Try both.
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        /* not plain JSON: fall through */
+    }
+    try {
+        return JSON.parse(decodeURIComponent(raw));
+    }
+    catch {
+        return null;
+    }
+}
+function serializeSession(session) {
+    return encodeURIComponent(JSON.stringify(session));
+}
+/**
+ * Browser cookie adapter. Falls back to in-memory storage when
+ * `document` is not available (SSR, Node.js environments).
+ */
+export function cookieStorage(options = {}) {
+    const doc = typeof document !== 'undefined' ? document : undefined;
+    if (!doc)
+        return memoryStorage();
+    const key = options.key ?? DEFAULT_KEY;
+    const path = options.path ?? '/';
+    const secure = options.secure ?? true;
+    const sameSite = options.sameSite ?? 'lax';
+    const pattern = new RegExp(`(?:^|; )${escapeRegex(key)}=([^;]*)`);
+    return {
+        get: () => {
+            const match = doc.cookie.match(pattern);
+            return parseSession(match?.[1]);
+        },
+        set: (session) => {
+            if (session) {
+                let cookie = `${key}=${serializeSession(session)}; path=${path}; SameSite=${sameSite}`;
+                if (secure)
+                    cookie += '; Secure';
+                doc.cookie = cookie;
+            }
+            else {
+                doc.cookie = `${key}=; path=${path}; max-age=0`;
+            }
+        },
+    };
+}
+/**
+ * Server-side cookie adapter built on batch `getAll`/`setAll` methods.
+ * The shape Next.js's `cookies()` (Server Components/Route Handlers) and
+ * `NextRequest.cookies`/`NextResponse.cookies` (middleware) already expose.
+ *
+ * `httpOnly` defaults to false, and that default is load-bearing: in the
+ * standard SSR setup `createBrowserClient` reads this same cookie from
+ * `document.cookie`, so hiding it from scripts signs the browser half out.
+ * Turn it on only when the browser client keeps its own copy elsewhere
+ * (`storage: localStorageStorage()`). Either way the cookie is unsigned, so
+ * `auth.getSession()` stays untrusted; `auth.getUser()` is the verified read.
+ */
+export function serverCookieStorage(cookies, key = DEFAULT_KEY, options = {}) {
+    const secure = options.secure ?? true;
+    const httpOnly = options.httpOnly ?? false;
+    return {
+        get: () => {
+            const match = cookies.getAll().find((c) => c.name === key);
+            return parseSession(match?.value);
+        },
+        set: (session) => {
+            if (!session) {
+                try {
+                    cookies.setAll([{ name: key, value: '', options: { path: '/', maxAge: 0 } }]);
+                }
+                catch {
+                    // Signing out from a Server Component cannot clear the cookie either,
+                    // but middleware will on the next navigation. Not worth a warning.
+                }
+                return;
+            }
+            try {
+                cookies.setAll([
+                    {
+                        name: key,
+                        // No percent-encoding here: `cookies().set()` encodes the value
+                        // itself, and encoding first yields a double-encoded cookie the
+                        // browser adapter can no longer parse.
+                        value: JSON.stringify(session),
+                        options: { path: '/', sameSite: 'lax', secure, httpOnly },
+                    },
+                ]);
+            }
+            catch (err) {
+                warnSessionCookieUnwritable(err instanceof Error ? err.message : String(err));
+                return;
+            }
+            // The adapter shape everyone copies wraps `setAll` in its own try/catch,
+            // so a refused write does not reach the catch above. It just does
+            // nothing. Reading it back is the only way to tell the difference.
+            if (!cookies.getAll().some((c) => c.name === key && c.value !== '')) {
+                warnSessionCookieUnwritable('the write was accepted but the cookie is not readable back');
+            }
+        },
+    };
+}
+//# sourceMappingURL=cookie.js.map

package/dist/cookie.js.map

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

package/dist/database.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Type-level plumbing for `createClient<Database>(url, key)`.
+ *
+ * `Database` is the type generated by `motherbase gen types typescript`, which
+ * emits the exact shape supabase-js emits. Everything here reads that shape and
+ * nothing else, so a `database.types.ts` produced by Supabase's own generator
+ * works unchanged.
+ *
+ * This file is types only: it contains no runtime code. The query builder it
+ * describes is the existing `PostgrestQueryBuilder`; `MotherbaseClient.from()`
+ * hands back the same object viewed through this narrower interface.
+ */
+import type { ExplainOptions, InsertOptions, MutateOptions, OrderOptions, PaginateOptions, PostgrestArrayOperand, PostgrestExplainBuilder, PostgrestFilterOperator, PostgrestIsValue, PostgrestResponse, PostgrestTextBuilder, ReferencedTableOption, SelectOptions, TextSearchType, UpsertOptions } from './postgrest.js';
+export interface GenericTable {
+    Row: Record<string, unknown>;
+    Insert: Record<string, unknown>;
+    Update: Record<string, unknown>;
+    Relationships?: unknown;
+}
+export interface GenericView {
+    Row: Record<string, unknown>;
+    Relationships?: unknown;
+}
+export interface GenericFunction {
+    Args: Record<string, unknown>;
+    Returns: unknown;
+}
+export interface GenericSchema {
+    Tables: Record<string, GenericTable>;
+    Views: Record<string, GenericView>;
+    Functions: Record<string, GenericFunction>;
+    Enums?: Record<string, unknown>;
+    CompositeTypes?: Record<string, unknown>;
+}
+/**
+ * The default when no `Database` is supplied. Every relation name is accepted
+ * and every row is `Record<string, unknown>`, which is exactly how the SDK
+ * behaved before generics existed. Passing a generated `Database` is opt-in.
+ */
+export type GenericDatabase = Record<string, GenericSchema>;
+/**
+ * The schema a client reads by default. `public` when the database has one,
+ * otherwise whatever single schema was generated: `motherbase gen types
+ * typescript --schema shop` emits only `shop`, and requiring every call site to
+ * pass the name again would be pure friction.
+ */
+export type DefaultSchemaName<Database> = 'public' extends keyof Database ? 'public' : keyof Database;
+export type SchemaOf<Database, Name> = Name extends keyof Database ? Database[Name] extends GenericSchema ? Database[Name] : GenericSchema : GenericSchema;
+/** Tables and views together: both are selectable through `.from()`. */
+export type Relations<Schema extends GenericSchema> = Schema['Tables'] & Schema['Views'];
+export type RelationName<Schema extends GenericSchema> = string & keyof Relations<Schema>;
+export type RowOf<Schema extends GenericSchema, Name extends RelationName<Schema>> = Relations<Schema>[Name] extends {
+    Row: infer R;
+} ? R : never;
+export type InsertOf<Schema extends GenericSchema, Name extends RelationName<Schema>> = Name extends keyof Schema['Tables'] ? Schema['Tables'][Name] extends {
+    Insert: infer I;
+} ? I : never : never;
+export type UpdateOf<Schema extends GenericSchema, Name extends RelationName<Schema>> = Name extends keyof Schema['Tables'] ? Schema['Tables'][Name] extends {
+    Update: infer U;
+} ? U : never : never;
+export type FunctionName<Schema extends GenericSchema> = string & keyof Schema['Functions'];
+export type FunctionArgs<Schema extends GenericSchema, Name extends FunctionName<Schema>> = Schema['Functions'][Name] extends {
+    Args: infer A;
+} ? A : never;
+export type FunctionReturns<Schema extends GenericSchema, Name extends FunctionName<Schema>> = Schema['Functions'][Name] extends {
+    Returns: infer R;
+} ? R : never;
+type Trim<S extends string> = S extends ` ${infer Rest}` ? Trim<Rest> : S extends `${infer Rest} ` ? Trim<Rest> : S;
+/** `'id, name'` -> `'id' | 'name'`. */
+type SplitColumns<S extends string> = S extends `${infer Head},${infer Tail}` ? Trim<Head> | SplitColumns<Tail> : Trim<S>;
+/** `'created_at::text'` -> `'created_at'`. Casts change the wire type, not the source column. */
+type StripCast<S extends string> = S extends `${infer Column}::${string}` ? Column : S;
+type AliasPart<S extends string> = S extends `${infer Alias}:${string}` ? Alias : S;
+type ColumnPart<S extends string> = S extends `${string}:${infer Column}` ? Column : S;
+/** `'writer:author_id'` -> `'writer'` (the key the row will carry). */
+type OutputName<S extends string> = AliasPart<StripCast<S>>;
+/** `'writer:author_id'` -> `'author_id'` (the column the type comes from). */
+type SourceName<S extends string> = ColumnPart<StripCast<S>>;
+/**
+ * SEAM: relational embedding (`select=*,author(*)`) is not implemented on the
+ * server yet, so a select string containing a parenthesised relation is not
+ * narrowed. It resolves to the base row plus an open index signature, which
+ * types the columns we do know and leaves the embedded keys accessible without
+ * pretending we know their shape.
+ *
+ * When embedding lands, replace this with a resolver that walks
+ * `Relationships` to decide object vs array and recurse into the target row.
+ */
+export type EmbeddedSelectSeam<Row> = Row & Record<string, unknown>;
+type IsEmbeddedSelect<S extends string> = S extends `${string}(${string}` ? true : false;
+/** Columns named in the select string that the relation does not have. */
+export type UnknownSelectColumns<Row, S extends string> = Exclude<SourceName<SplitColumns<S>>, (keyof Row & string) | '*'>;
+/**
+ * The `columns` argument type. Resolves to `unknown` (no extra constraint) when
+ * every named column exists, and to an error-message string literal otherwise,
+ * so a typo fails at the call site with the offending name in the message.
+ */
+export type ValidateSelect<Row, S extends string> = IsEmbeddedSelect<S> extends true ? unknown : [UnknownSelectColumns<Row, S>] extends [never] ? unknown : `Unknown column in select: ${UnknownSelectColumns<Row, S> & string}`;
+/** The row shape a select resolves to. */
+export type SelectResult<Row, S extends string> = IsEmbeddedSelect<S> extends true ? EmbeddedSelectSeam<Row> : '*' extends SplitColumns<S> ? Row : {
+    [K in SplitColumns<S> as OutputName<K>]: Row[SourceName<K> & keyof Row];
+};
+export type FilterValue = string | number | boolean | null;
+/** Columns that can be filtered or ordered on. Any string when untyped. */
+export type ColumnName<Row> = keyof Row & string;
+/**
+ * The `.from()` result. Structurally the existing `PostgrestQueryBuilder`, with
+ * the generated row/insert/update types threaded through. `Result` tracks what
+ * the current `select` narrowed the row to; it starts as the full row.
+ */
+export interface TypedQuery<Row, Insert, Update, Result = Row> extends PromiseLike<PostgrestResponse<Result[]>> {
+    select<S extends string = '*'>(columns?: S & ValidateSelect<Row, S>, options?: SelectOptions): TypedQuery<Row, Insert, Update, SelectResult<Row, S>>;
+    insert(values: Insert | readonly Insert[], options?: InsertOptions): TypedQuery<Row, Insert, Update, Result>;
+    upsert(values: Insert | readonly Insert[], options?: UpsertOptions): TypedQuery<Row, Insert, Update, Result>;
+    update(values: Update, options?: MutateOptions): TypedQuery<Row, Insert, Update, Result>;
+    delete(options?: MutateOptions): TypedQuery<Row, Insert, Update, Result>;
+    eq(column: ColumnName<Row>, value: FilterValue): this;
+    neq(column: ColumnName<Row>, value: FilterValue): this;
+    gt(column: ColumnName<Row>, value: FilterValue): this;
+    gte(column: ColumnName<Row>, value: FilterValue): this;
+    lt(column: ColumnName<Row>, value: FilterValue): this;
+    lte(column: ColumnName<Row>, value: FilterValue): this;
+    like(column: ColumnName<Row>, pattern: string): this;
+    ilike(column: ColumnName<Row>, pattern: string): this;
+    likeAllOf(column: ColumnName<Row>, patterns: readonly string[]): this;
+    likeAnyOf(column: ColumnName<Row>, patterns: readonly string[]): this;
+    ilikeAllOf(column: ColumnName<Row>, patterns: readonly string[]): this;
+    ilikeAnyOf(column: ColumnName<Row>, patterns: readonly string[]): this;
+    in(column: ColumnName<Row>, values: readonly FilterValue[]): this;
+    is(column: ColumnName<Row>, value: PostgrestIsValue): this;
+    match(query: Partial<Record<ColumnName<Row>, FilterValue>>): this;
+    /** Escape hatches: the column is a free string so json paths (`data->>k`) work. */
+    not(column: string, operator: PostgrestFilterOperator | (string & {}), value: FilterValue | readonly FilterValue[]): this;
+    filter(column: string, operator: PostgrestFilterOperator | (string & {}), value: FilterValue | readonly FilterValue[]): this;
+    or(filters: string, options?: ReferencedTableOption): this;
+    textSearch(column: ColumnName<Row>, query: string, options?: {
+        type?: TextSearchType;
+        config?: string;
+    }): this;
+    contains(column: ColumnName<Row>, value: PostgrestArrayOperand): this;
+    containedBy(column: ColumnName<Row>, value: PostgrestArrayOperand): this;
+    overlaps(column: ColumnName<Row>, value: PostgrestArrayOperand): this;
+    rangeGt(column: ColumnName<Row>, range: string): this;
+    rangeGte(column: ColumnName<Row>, range: string): this;
+    rangeLt(column: ColumnName<Row>, range: string): this;
+    rangeLte(column: ColumnName<Row>, range: string): this;
+    rangeAdjacent(column: ColumnName<Row>, range: string): this;
+    order(column: ColumnName<Row>, options?: OrderOptions): this;
+    limit(count: number, options?: ReferencedTableOption): this;
+    range(from: number, to: number, options?: ReferencedTableOption): this;
+    abortSignal(signal: AbortSignal): this;
+    /** Re-type the rows: for shapes the generated `Database` cannot express. */
+    returns<T>(): TypedQuery<Row, Insert, Update, T>;
+    overrideTypes<T>(): TypedQuery<Row, Insert, Update, T>;
+    /** Reject instead of resolving `{ data: null, error }`. */
+    throwOnError(): this;
+    /** Refuse the write if it would touch more than `count` rows. */
+    maxAffected(count: number): this;
+    /** Run the query, then roll the transaction back. */
+    rollback(): this;
+    csv(): PostgrestTextBuilder;
+    geojson(): PostgrestExplainBuilder;
+    explain(options?: ExplainOptions): PostgrestExplainBuilder;
+    /**
+     * Walk every matching row instead of stopping at the server's row cap.
+     * Throws on error: a `for await` loop has nowhere to put an error value, and
+     * ending the iteration quietly looks exactly like reaching the last page.
+     */
+    stream(options?: PaginateOptions): AsyncGenerator<Result, void, undefined>;
+    paginate(options?: PaginateOptions): AsyncGenerator<{
+        rows: Result[];
+        from: number;
+        count: number | null;
+    }, void, undefined>;
+    single(): TypedSingleQuery<Result>;
+    maybeSingle(): TypedSingleQuery<Result | null>;
+    /** The URL path (with query string) this builder targets. Exposed for tests. */
+    toPath(): string;
+    /** The headers this builder sends (Prefer, Accept). Exposed for tests. */
+    toHeaders(): Record<string, string>;
+}
+/** A builder narrowed to one row by `.single()` / `.maybeSingle()`. */
+export interface TypedSingleQuery<Result> extends PromiseLike<PostgrestResponse<Result>> {
+    toPath(): string;
+    toHeaders(): Record<string, string>;
+}
+export {};
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

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

package/dist/database.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":""}

package/dist/functions.d.ts

@@ -0,0 +1,60 @@
+import type { HttpClient } from './http.js';
+import type { MotherbaseResponse } from './types.js';
+export type FunctionInvokeAuth = {
+    type: 'edge-token';
+    token: string;
+} | {
+    type: 'public';
+};
+export interface FunctionInvokeOptions<Body = unknown> {
+    /** JSON body passed to the edge function. */
+    body?: Body;
+    /**
+     * Authentication override. By default the current session bearer is used.
+     * Public and dedicated Edge-token invocations must be explicitly selected.
+     */
+    auth?: FunctionInvokeAuth;
+    /** HTTP method the function receives. Defaults to POST, as in supabase-js. */
+    method?: 'POST' | 'GET' | 'PUT' | 'PATCH' | 'DELETE';
+    /** Extra request headers, forwarded to the function. */
+    headers?: Record<string, string>;
+    /**
+     * Accepted for supabase-js signature parity and ignored: a self-hosted
+     * Motherbase runs its functions in one place, so there is no region to pick.
+     */
+    region?: string;
+}
+/**
+ * The error classes supabase-js throws from `functions.invoke`.
+ *
+ * Ported code branches on them (`if (error instanceof FunctionsHttpError)`), so
+ * they exist here and `invoke` puts the matching instance in `error`. It still
+ * resolves rather than throws: the `{ data, error }` envelope is the contract
+ * everywhere else in this SDK, and a method that sometimes throws and sometimes
+ * does not is worse than either.
+ */
+export declare class FunctionsError extends Error {
+    readonly name_: string;
+    readonly context?: unknown | undefined;
+    constructor(message: string, name_?: string, context?: unknown | undefined);
+}
+/** The function ran and answered with a non-2xx status. */
+export declare class FunctionsHttpError extends FunctionsError {
+    readonly status?: number;
+    constructor(message: string, status?: number, context?: unknown);
+}
+/** The function threw before producing a response. */
+export declare class FunctionsRelayError extends FunctionsError {
+    constructor(message: string, context?: unknown);
+}
+/** The request never reached the function (network, abort, DNS). */
+export declare class FunctionsFetchError extends FunctionsError {
+    constructor(message: string, context?: unknown);
+}
+/** Supabase-compatible edge functions client: `client.functions.invoke(name, { body })`. */
+export declare class FunctionsClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    invoke<Result = unknown, Body = Record<string, unknown>>(name: string, options?: FunctionInvokeOptions<Body>): Promise<MotherbaseResponse<Result>>;
+}
+//# sourceMappingURL=functions.d.ts.map

package/dist/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../src/functions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,MAAM,WAAW,qBAAqB,CAAC,IAAI,GAAG,OAAO;IACnD,6CAA6C;IAC7C,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACV,QAAQ,CAAC,KAAK;IAAqB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO;gBAA9E,OAAO,EAAE,MAAM,EAAW,KAAK,SAAmB,EAAW,OAAO,CAAC,EAAE,OAAO,YAAA;CAI3F;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAIhE;AAED,sDAAsD;AACtD,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED,oEAAoE;AACpE,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED,4FAA4F;AAC5F,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEvC,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,CAAC,IAAI,CAAM,GACxC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;CAgCvC"}

package/dist/functions.js

@@ -0,0 +1,75 @@
+import { BackendError, toError } from './http.js';
+import { warnIgnoredOption } from './warn.js';
+import { contractPath } from '@motherbase/contracts';
+/**
+ * The error classes supabase-js throws from `functions.invoke`.
+ *
+ * Ported code branches on them (`if (error instanceof FunctionsHttpError)`), so
+ * they exist here and `invoke` puts the matching instance in `error`. It still
+ * resolves rather than throws: the `{ data, error }` envelope is the contract
+ * everywhere else in this SDK, and a method that sometimes throws and sometimes
+ * does not is worse than either.
+ */
+export class FunctionsError extends Error {
+    constructor(message, name_ = 'FunctionsError', context) {
+        super(message);
+        this.name_ = name_;
+        this.context = context;
+        this.name = name_;
+    }
+}
+/** The function ran and answered with a non-2xx status. */
+export class FunctionsHttpError extends FunctionsError {
+    constructor(message, status, context) {
+        super(message, 'FunctionsHttpError', context);
+        this.status = status;
+    }
+}
+/** The function threw before producing a response. */
+export class FunctionsRelayError extends FunctionsError {
+    constructor(message, context) {
+        super(message, 'FunctionsRelayError', context);
+    }
+}
+/** The request never reached the function (network, abort, DNS). */
+export class FunctionsFetchError extends FunctionsError {
+    constructor(message, context) {
+        super(message, 'FunctionsFetchError', context);
+    }
+}
+/** Supabase-compatible edge functions client: `client.functions.invoke(name, { body })`. */
+export class FunctionsClient {
+    constructor(http) {
+        this.http = http;
+    }
+    async invoke(name, options = {}) {
+        try {
+            if (options.region) {
+                warnIgnoredOption('functions.invoke', 'region', 'A self-hosted Motherbase runs every function in one place, so the call goes there regardless.');
+            }
+            const edgeToken = options.auth?.type === 'edge-token' ? options.auth.token : undefined;
+            const method = options.method ?? 'POST';
+            const data = await this.http.request(contractPath.edge(name), {
+                method,
+                // A GET or DELETE with a JSON body is refused by some proxies and means
+                // nothing to the function, so the body is only sent where it can be read.
+                body: method === 'GET' || method === 'DELETE' ? undefined : (options.body ?? {}),
+                anonymous: options.auth !== undefined,
+                headers: {
+                    ...options.headers,
+                    ...(edgeToken ? { 'x-motherbase-edge-token': edgeToken } : {}),
+                },
+            });
+            return { data, error: null };
+        }
+        catch (err) {
+            const base = toError(err);
+            const status = err instanceof BackendError ? err.httpStatus : 0;
+            const error = status
+                ? Object.assign(new FunctionsHttpError(base.message, status), base)
+                : Object.assign(new FunctionsFetchError(base.message), base);
+            return { data: null, error };
+        }
+    }
+}
+//# sourceMappingURL=functions.js.map

package/dist/functions.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,122 @@
+import type { SessionStore } from './session.js';
+export declare class BackendError extends Error {
+    /** HTTP status code (0 if the request never completed). */
+    readonly httpStatus: number;
+    /** The API envelope's `status` field when present. */
+    readonly apiStatus?: number;
+    /** Backend error code, when present. */
+    readonly code?: string;
+    /**
+     * Correlation id for the failed request, from the `x-request-id` response
+     * header (the backend also puts it in the error body). Quote it in a bug
+     * report or log it next to your own error: it is what matches this call to
+     * the server-side stack trace in the project's logs.
+     */
+    readonly requestId?: string;
+    constructor(message: string, httpStatus: number, apiStatus?: number, code?: string, requestId?: string);
+}
+export interface RequestOptions {
+    method?: string;
+    /** Headers scoped to this request. Override client-level headers. */
+    headers?: Record<string, string>;
+    /** JSON body. Mutually exclusive with `form`. */
+    body?: unknown;
+    /** Multipart body. Mutually exclusive with `body`. */
+    form?: FormData;
+    /** Skip attaching the Authorization header (used by auth endpoints). */
+    anonymous?: boolean;
+    /** Abort the request when this signal fires (`.abortSignal(signal)`). */
+    signal?: AbortSignal;
+    /**
+     * Parse the response body as-is instead of unwrapping the app's
+     * `{ status, data }` envelope. Better Auth's native /api/auth/* endpoints
+     * return plain JSON, so the auth client sets this.
+     */
+    raw?: boolean;
+    /**
+     * Cookie mode for this request. Defaults to fetch's own `same-origin`.
+     * OAuth start endpoints need `'include'`: better-auth sets a signed state
+     * cookie on that response and verifies it on the provider callback, and a
+     * cross-origin response's cookie is discarded without it (the callback then
+     * fails with `state_mismatch`).
+     */
+    credentials?: RequestCredentials;
+    /** Internal: prevents infinite refresh recursion. */
+    _retry?: boolean;
+}
+/** What every request reports to `client.on('request', ...)`. */
+export interface RequestEvent {
+    method: string;
+    /** Path with query string, as sent. */
+    path: string;
+    /** HTTP status, or 0 when the request never completed (network, abort). */
+    status: number;
+    /** Wall time from send to response headers, in milliseconds. */
+    durationMs: number;
+    /** `x-request-id`, the id to quote when reporting a server-side failure. */
+    requestId?: string;
+    /** Set when the request failed outright rather than answering. */
+    error?: unknown;
+}
+export type RequestObserver = (event: RequestEvent) => void;
+/**
+ * fetch wrapper that injects the bearer token, unwraps the API envelope, maps
+ * failures to BackendError, and performs single-flight token refresh on 401.
+ */
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly store;
+    private readonly opts;
+    /** Performs the refresh; returns true on success. Injected to avoid a cycle. */
+    private readonly doRefresh;
+    private refreshPromise;
+    constructor(baseUrl: string, store: SessionStore, opts: {
+        autoRefresh: boolean;
+        fetch: typeof fetch;
+        headers?: Record<string, string>;
+        /** Called once per HTTP round trip, including the retry after a refresh. */
+        onRequest?: RequestObserver;
+    }, 
+    /** Performs the refresh; returns true on success. Injected to avoid a cycle. */
+    doRefresh: () => Promise<boolean>);
+    /**
+     * Install (or clear) the request observer.
+     *
+     * Set rather than constructed, so `client.on('request', ...)` can be called
+     * after the client exists, and cleared again when the last listener goes: the
+     * timing path is skipped entirely while nobody is watching.
+     */
+    setRequestObserver(observer: RequestObserver | undefined): void;
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Like `request`, but keeps the response headers. PostgREST puts the row count
+     * in `Content-Range`, which is unreachable from the parsed body alone.
+     */
+    requestWithHeaders<T>(path: string, options?: RequestOptions): Promise<{
+        data: T;
+        headers: Headers;
+        status: number;
+    }>;
+    /** Like `request`, but returns the raw Response (for binary downloads). */
+    requestRaw(path: string, options?: RequestOptions): Promise<Response>;
+    private sendWithRefresh;
+    /** Shared single-flight refresh: concurrent callers await the same promise. */
+    private refreshOnce;
+    private send;
+    /** An observer that throws must not fail the request it was watching. */
+    private emit;
+    private parse;
+    /** Parse a plain-JSON (non-envelope) response, mapping failures to BackendError. */
+    private parseRaw;
+    /** Absolute URL for a path. Public so callers can navigate to an endpoint
+     *  rather than fetch it (see AuthClient.signInWithOAuth). */
+    url(path: string): string;
+}
+/** Convert a thrown BackendError (or any error) into a Supabase-shaped error object. */
+export declare function toError(err: unknown): {
+    message: string;
+    status?: number;
+    code?: string;
+    requestId?: string;
+};
+//# sourceMappingURL=http.d.ts.map