@motherbase/client 2.2.1 → 2.2.3

package/dist/cookies/utils.js

@@ -0,0 +1,67 @@
+let warnedAboutCookieWrite = false;
+/** Browsers drop a cookie past ~4096 bytes, silently signing the user out. */
+const COOKIE_WARN_LENGTH = 3800;
+let warnedAboutCookieSize = 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 `auth.getSession()` returns 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.
+ */
+export 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.getSession() returns null on every request.');
+}
+export 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;
+    }
+}
+export function serializeSession(session) {
+    const value = encodeURIComponent(JSON.stringify(session));
+    if (!warnedAboutCookieSize && value.length > COOKIE_WARN_LENGTH && !isProduction()) {
+        warnedAboutCookieSize = true;
+        console.warn(`[motherbase] The serialized session is ${value.length} characters, close to the ~4096 byte `
+            + 'browser cookie limit. An oversized cookie is dropped silently and the user appears signed '
+            + 'out. Trim custom user metadata, or use `localStorageStorage()` for the browser client.');
+    }
+    return value;
+}
+//# sourceMappingURL=utils.js.map

package/dist/cookies/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cookies/utils.ts"],"names":[],"mappings":"AAGA,IAAI,sBAAsB,GAAG,KAAK,CAAC;AAEnC,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,IAAI,qBAAqB,GAAG,KAAK,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,YAAY;IACxB,MAAM,IAAI,GAAI,UAAyE,CAAC,OAAO,CAAC;IAChG,OAAO,IAAI,EAAE,GAAG,EAAE,QAAQ,KAAK,YAAY,CAAC;AAChD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAc;IACtD,IAAI,sBAAsB;QAAE,OAAO;IACnC,IAAI,YAAY,EAAE;QAAE,OAAO;IAC3B,sBAAsB,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,IAAI,CACR,yDAAyD,MAAM,8BAA8B;UAC3F,2FAA2F;UAC3F,0FAA0F;UAC1F,uDAAuD,CAC5D,CAAC;AACN,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,GAAuB;IAChD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,2EAA2E;IAC3E,kEAAkE;IAClE,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACL,kCAAkC;IACtC,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAY,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAID,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC7C,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,qBAAqB,IAAI,KAAK,CAAC,MAAM,GAAG,kBAAkB,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACjF,qBAAqB,GAAG,IAAI,CAAC;QAC7B,OAAO,CAAC,IAAI,CACR,0CAA0C,KAAK,CAAC,MAAM,uCAAuC;cAC3F,4FAA4F;cAC5F,wFAAwF,CAC7F,CAAC;IACN,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/database/database.d.ts

@@ -0,0 +1,197 @@
+/**
+ * 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/index.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;
+/** A write without `.select()` stays `null` through re-typing and `.single()`. */
+type RowsUnlessWrite<Data, Rows> = Data extends null ? null : Rows;
+/** 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.
+ *
+ * `Data` is what awaiting resolves to. A write is sent with `return=minimal`
+ * and resolves `data: null` until `.select()` asks for the rows back, as in
+ * supabase-js; typing it as rows let `data.id` after a bare `insert()` compile
+ * and fail at runtime.
+ */
+export interface TypedQuery<Row, Insert, Update, Result = Row, Data = Result[]> extends PromiseLike<PostgrestResponse<Data>> {
+    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, null>;
+    upsert(values: Insert | readonly Insert[], options?: UpsertOptions): TypedQuery<Row, Insert, Update, Result, null>;
+    update(values: Update, options?: MutateOptions): TypedQuery<Row, Insert, Update, Result, null>;
+    delete(options?: MutateOptions): TypedQuery<Row, Insert, Update, Result, null>;
+    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;
+    /** Send one more header with this request only, e.g. `x-captcha-response`. */
+    setHeader(name: string, value: string): this;
+    /** Re-type the rows: for shapes the generated `Database` cannot express. */
+    returns<T>(): TypedQuery<Row, Insert, Update, T, RowsUnlessWrite<Data, T[]>>;
+    overrideTypes<T>(): TypedQuery<Row, Insert, Update, T, RowsUnlessWrite<Data, 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<RowsUnlessWrite<Data, Result>>;
+    maybeSingle(): TypedSingleQuery<RowsUnlessWrite<Data, 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/database.d.ts.map

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

package/dist/database/database.js

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

package/dist/database/database.js.map

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

package/dist/database/facade.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Prisma-shaped access to a table, as an alternative to `client.from()`:
+ *
+ * ```ts
+ * const posts = await client.db.posts.findMany({
+ *   where: { published: true, views: { gt: 100 } },
+ *   select: { id: true, title: true },
+ *   orderBy: { created_at: 'desc' },
+ *   take: 20,
+ * })
+ * ```
+ *
+ * A second syntax, not a second query engine. Each method translates its
+ * arguments into calls on the same `PostgrestQueryBuilder` that `from()`
+ * returns (`where: { views: { gt: 100 } }` becomes `.gt('views', 100)`), so
+ * both send identical requests. What the facade cannot express (embedded
+ * relations, `or`, json paths) stays one `client.from()` away.
+ *
+ * Failures throw, as in Prisma. A facade resolving `{ data, error }` would
+ * differ from `from()` in argument shape only.
+ */
+import type { PostgrestQueryBuilder } from '../postgrest/query-builder.js';
+import type { GenericSchema, InsertOf, RelationName, RowOf, UpdateOf } from './types.js';
+/** The conditions one column can take in a `where`. Several on one column are ANDed. */
+export interface WhereOperators<Value> {
+    /** Equal to the value. `null` matches NULL. */
+    equals?: Value | null;
+    /** Different from the value. `null` matches every non-NULL value. */
+    not?: Value | null;
+    /** Equal to one of the values. */
+    in?: readonly Value[];
+    /** Greater than. */
+    gt?: Value;
+    /** Greater than or equal. */
+    gte?: Value;
+    /** Less than. */
+    lt?: Value;
+    /** Less than or equal. */
+    lte?: Value;
+    /** Text containing this string, case-sensitive. */
+    contains?: string;
+    /** Text starting with this string, case-sensitive. */
+    startsWith?: string;
+    /** Text ending with this string, case-sensitive. */
+    endsWith?: string;
+}
+/** Per column, a bare value (meaning `equals`) or operators. Columns are ANDed. */
+export type Where<Row> = {
+    [Column in keyof Row]?: Row[Column] | WhereOperators<Row[Column]>;
+};
+/** The columns to read: `{ id: true, title: true }`. Omitted, every column is read. */
+export type SelectColumns<Row> = {
+    [Column in keyof Row]?: true;
+};
+/** Sort order per column, applied in key order: `{ created_at: 'desc', id: 'asc' }`. */
+export type OrderBy<Row> = {
+    [Column in keyof Row]?: 'asc' | 'desc';
+};
+/** What `findMany()` and `findFirst()` accept. Every field is optional. */
+export interface FindManyArgs<Row, Select extends SelectColumns<Row> | undefined = undefined> {
+    /** Which rows: `{ published: true, views: { gt: 100 } }`. */
+    where?: Where<Row>;
+    /** Which columns: `{ id: true, title: true }`. The result type narrows to them. */
+    select?: Select;
+    /** Sort order: `{ created_at: 'desc' }`. */
+    orderBy?: OrderBy<Row>;
+    /** Return at most this many rows. */
+    take?: number;
+    /** Skip this many rows first. Needs `take`. */
+    skip?: number;
+}
+/** `select: { id: true }` narrows each result to `Pick<Row, 'id'>`; no select is the whole row. */
+export type Selected<Row, Select> = Select extends SelectColumns<Row> ? Pick<Row, Extract<keyof Select, keyof Row>> : Row;
+/**
+ * One table, Prisma-style: what `client.db.<table>` returns. Every method
+ * throws on failure.
+ */
+export interface TableFacade<Row, Insert, Update> {
+    /**
+     * Read every row matching `where`.
+     * @example await client.db.posts.findMany({ where: { published: true }, orderBy: { created_at: 'desc' }, take: 20 })
+     */
+    findMany<Select extends SelectColumns<Row> | undefined = undefined>(args?: FindManyArgs<Row, Select>): Promise<Selected<Row, Select>[]>;
+    /**
+     * Read the first row matching `where`, or `null` when none does.
+     * @example await client.db.posts.findFirst({ where: { slug } })
+     */
+    findFirst<Select extends SelectColumns<Row> | undefined = undefined>(args?: Omit<FindManyArgs<Row, Select>, 'take'>): Promise<Selected<Row, Select> | null>;
+    /**
+     * Insert one row and resolve it as stored, defaults and generated ids included.
+     * @example const post = await client.db.posts.create({ data: { title } })
+     */
+    create(args: {
+        data: Insert;
+    }): Promise<Row>;
+    /**
+     * Update every row matching `where` and resolve the updated rows (Prisma
+     * resolves `{ count }`). Throws if `where` matches no column, so an id that
+     * is `undefined` at runtime cannot update the whole table.
+     * @example await client.db.posts.updateMany({ where: { id }, data: { title } })
+     */
+    updateMany(args: {
+        where: Where<Row>;
+        data: Update;
+    }): Promise<Row[]>;
+    /**
+     * Delete every row matching `where` and resolve the deleted rows. Throws if
+     * `where` matches no column, so an id that is `undefined` at runtime cannot
+     * empty the table.
+     * @example await client.db.posts.deleteMany({ where: { id } })
+     */
+    deleteMany(args: {
+        where: Where<Row>;
+    }): Promise<Row[]>;
+}
+/** `client.db`: one `TableFacade` per table or view of the generated `Database`. */
+export type DatabaseFacade<Schema extends GenericSchema> = {
+    [Name in RelationName<Schema>]: TableFacade<RowOf<Schema, Name>, InsertOf<Schema, Name>, UpdateOf<Schema, Name>>;
+};
+type Builder = PostgrestQueryBuilder<any>;
+type Operator = keyof WhereOperators<unknown>;
+interface Filter {
+    column: string;
+    operator: Operator;
+    value: unknown;
+}
+/**
+ * Flatten a `where` into one filter per condition:
+ * `{ published: true, views: { gt: 1, lt: 9 } }` is three filters.
+ *
+ * An `undefined` value means "no filter", as in Prisma, so `{ author_id: maybeId }`
+ * reads naturally. `requireFilters` is what stops that from widening a write.
+ */
+export declare function filtersOf(where?: object): Filter[];
+/** The read half: `findMany` arguments applied to a fresh builder. Exported for tests. */
+export declare function applyFindArgs(query: Builder, args?: FindManyArgs<any, any>): Builder;
+/**
+ * One table's facade. `newQuery` returns a fresh builder for that table on
+ * every call. Every method is `async`, so a refused write rejects like a failed
+ * one instead of throwing synchronously.
+ */
+export declare function tableFacade<Row, Insert, Update>(newQuery: () => Builder): TableFacade<Row, Insert, Update>;
+export {};
+//# sourceMappingURL=facade.d.ts.map

package/dist/database/facade.d.ts.map

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

package/dist/database/facade.js

@@ -0,0 +1,147 @@
+const OPERATORS = new Set([
+    'equals', 'not', 'in', 'gt', 'gte', 'lt', 'lte', 'contains', 'startsWith', 'endsWith',
+]);
+/**
+ * An operator object, as opposed to a bare value. Every key must be an
+ * operator, so a json column compared to `{ theme: 'dark' }` stays a value.
+ */
+function isOperators(condition) {
+    if (typeof condition !== 'object' || condition === null || Array.isArray(condition))
+        return false;
+    const keys = Object.keys(condition);
+    return keys.length > 0 && keys.every(key => OPERATORS.has(key));
+}
+/**
+ * Flatten a `where` into one filter per condition:
+ * `{ published: true, views: { gt: 1, lt: 9 } }` is three filters.
+ *
+ * An `undefined` value means "no filter", as in Prisma, so `{ author_id: maybeId }`
+ * reads naturally. `requireFilters` is what stops that from widening a write.
+ */
+export function filtersOf(where = {}) {
+    const filters = [];
+    for (const [column, condition] of Object.entries(where)) {
+        if (isOperators(condition)) {
+            for (const [operator, value] of Object.entries(condition)) {
+                filters.push({ column, operator: operator, value });
+            }
+        }
+        else {
+            filters.push({ column, operator: 'equals', value: condition });
+        }
+    }
+    return filters.filter(filter => filter.value !== undefined);
+}
+function applyFilter(query, { column, operator, value }) {
+    const v = value;
+    switch (operator) {
+        // SQL's `= NULL` matches nothing: a null comparison has to be `IS NULL`.
+        case 'equals':
+            if (value === null)
+                query.is(column, null);
+            else
+                query.eq(column, v);
+            return;
+        case 'not':
+            if (value === null)
+                query.not(column, 'is', null);
+            else
+                query.neq(column, v);
+            return;
+        case 'in':
+            query.in(column, v);
+            return;
+        case 'gt':
+            query.gt(column, v);
+            return;
+        case 'gte':
+            query.gte(column, v);
+            return;
+        case 'lt':
+            query.lt(column, v);
+            return;
+        case 'lte':
+            query.lte(column, v);
+            return;
+        // `*` is PostgREST's LIKE wildcard.
+        // ponytail: a `*` inside the value is a wildcard too; escape it if literal stars need matching.
+        case 'contains':
+            query.like(column, `*${v}*`);
+            return;
+        case 'startsWith':
+            query.like(column, `${v}*`);
+            return;
+        case 'endsWith':
+            query.like(column, `*${v}`);
+            return;
+    }
+}
+/**
+ * A write with no filter touches every row. Prisma allows it; here it takes
+ * `client.from(table)` written out, so an id that was `undefined` at runtime
+ * cannot turn a targeted delete into a table wipe.
+ */
+function requireFilters(where, method) {
+    const filters = filtersOf(where);
+    if (!filters.length) {
+        throw new Error(`${method}(): where matched no column. Use client.from(table) to write every row.`);
+    }
+    return filters;
+}
+/** The read half: `findMany` arguments applied to a fresh builder. Exported for tests. */
+export function applyFindArgs(query, args = {}) {
+    query.select(args.select ? Object.keys(args.select).join(',') : '*');
+    for (const filter of filtersOf(args.where))
+        applyFilter(query, filter);
+    for (const [column, direction] of Object.entries(args.orderBy ?? {})) {
+        query.order(column, { ascending: direction === 'asc' });
+    }
+    if (args.take !== undefined) {
+        const skip = args.skip ?? 0;
+        query.range(skip, skip + args.take - 1);
+    }
+    else if (args.skip !== undefined) {
+        throw new Error('findMany(): skip needs take, the builder only offsets through range().');
+    }
+    return query;
+}
+/**
+ * `data` of a query sent with `throwOnError()`. Such a query only resolves on
+ * success, so `data` is set, whatever the `{ data, error }` envelope type says.
+ */
+async function dataOf(query) {
+    return (await query).data;
+}
+/**
+ * One table's facade. `newQuery` returns a fresh builder for that table on
+ * every call. Every method is `async`, so a refused write rejects like a failed
+ * one instead of throwing synchronously.
+ */
+export function tableFacade(newQuery) {
+    return {
+        async findMany(args) {
+            return dataOf(applyFindArgs(newQuery(), args).throwOnError());
+        },
+        async findFirst(args) {
+            return dataOf(applyFindArgs(newQuery(), { ...args, take: 1 }).throwOnError().maybeSingle());
+        },
+        async create({ data }) {
+            return dataOf(newQuery().insert(data).select().throwOnError().single());
+        },
+        async updateMany({ where, data }) {
+            const filters = requireFilters(where, 'updateMany');
+            const query = newQuery().update(data);
+            for (const filter of filters)
+                applyFilter(query, filter);
+            return dataOf(query.select().throwOnError());
+        },
+        async deleteMany({ where }) {
+            const filters = requireFilters(where, 'deleteMany');
+            const query = newQuery().delete();
+            for (const filter of filters)
+                applyFilter(query, filter);
+            return dataOf(query.select().throwOnError());
+        },
+    };
+}
+//# sourceMappingURL=facade.js.map

package/dist/database/facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.js","sourceRoot":"","sources":["../../src/database/facade.ts"],"names":[],"mappings":"AA+HA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS;IAChC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU;CACjE,CAAC,CAAC;AAQxB;;;GAGG;AACH,SAAS,WAAW,CAAC,SAAkB;IACrC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAClG,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1D,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAU;IACtE,MAAM,CAAC,GAAG,KAAY,CAAC;IACvB,QAAQ,QAAQ,EAAE,CAAC;QACjB,yEAAyE;QACzE,KAAK,QAAQ;YAAE,IAAI,KAAK,KAAK,IAAI;gBAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;;gBAAM,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO;QAC5F,KAAK,KAAK;YAAE,IAAI,KAAK,KAAK,IAAI;gBAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;;gBAAM,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO;QACjG,KAAK,IAAI;YAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO;QACvC,KAAK,IAAI;YAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO;QACvC,KAAK,KAAK;YAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO;QACzC,KAAK,IAAI;YAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO;QACvC,KAAK,KAAK;YAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAAC,OAAO;QACzC,oCAAoC;QACpC,gGAAgG;QAChG,KAAK,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAAC,OAAO;QACtD,KAAK,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YAAC,OAAO;QACvD,KAAK,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAAC,OAAO;IACvD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,KAAa,EAAE,MAAc;IACnD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,yEAAyE,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAA+B,EAAE;IAC7E,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrE,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvE,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QAC5B,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,MAAM,CAAC,KAAqC;IACzD,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAsB,QAAuB;IACtE,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,IAAI;YACjB,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,IAAI;YAClB,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE;YACnB,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAc,CAAC,CAAC,MAAM,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;YAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAc,CAAC,CAAC;YAChD,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACzD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE;YACxB,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;YAClC,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACzD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}