@palbase/backend 22.1.0 → 23.1.0

package/dist/db/env.d.cts

@@ -1,3 +1,5 @@
+export { BucketTypes, Buckets } from '../stack.cjs';
+
 /**
  * `@palbase/backend/env` — the controlled global augmentation target for the
  * project's schema.
@@ -55,25 +57,5 @@ interface TableTypes {
  */
 interface Tables {
 }
-/**
- * One typed bucket: which renditions `config/storage.ts` declared for it.
- *
- * `variants` is a UNION of the declared names, so asking for one the bucket
- * does not have is a compile error rather than a 404 somebody finds in
- * production. The generated `palbase-env.d.ts` fills it; the default `never`
- * means a bucket declared without variants accepts no variant name at all,
- * which is exactly right.
- */
-interface BucketTypes {
-    variants: string;
-}
-/**
- * The project's storage buckets, keyed by bucket name. EMPTY by default; the
- * generated `palbase-env.d.ts` augments it, so `Storage.buckets` is typed
- * everywhere with no per-file import — the same mechanism `Tables` uses, and
- * deliberately so: an author learns one pattern.
- */
-interface Buckets {
-}
 
-export type { BucketTypes, Buckets, TableTypes, Tables };
+export type { TableTypes, Tables };

package/dist/db/env.d.ts

@@ -1,3 +1,5 @@
+export { BucketTypes, Buckets } from '../stack.js';
+
 /**
  * `@palbase/backend/env` — the controlled global augmentation target for the
  * project's schema.
@@ -55,25 +57,5 @@ interface TableTypes {
  */
 interface Tables {
 }
-/**
- * One typed bucket: which renditions `config/storage.ts` declared for it.
- *
- * `variants` is a UNION of the declared names, so asking for one the bucket
- * does not have is a compile error rather than a 404 somebody finds in
- * production. The generated `palbase-env.d.ts` fills it; the default `never`
- * means a bucket declared without variants accepts no variant name at all,
- * which is exactly right.
- */
-interface BucketTypes {
-    variants: string;
-}
-/**
- * The project's storage buckets, keyed by bucket name. EMPTY by default; the
- * generated `palbase-env.d.ts` augments it, so `Storage.buckets` is typed
- * everywhere with no per-file import — the same mechanism `Tables` uses, and
- * deliberately so: an author learns one pattern.
- */
-interface Buckets {
-}
 
-export type { BucketTypes, Buckets, TableTypes, Tables };
+export type { TableTypes, Tables };

package/dist/db/index.cjs

@@ -47,6 +47,9 @@ __export(db_exports, {
 module.exports = __toCommonJS(db_exports);
 
 // src/db/policy.ts
+function quote(name) {
+  return `"${name.replace(/"/g, '""')}"`;
+}
 var PolicyBuilder = class {
   _def;
   constructor(name) {
@@ -82,6 +85,41 @@ var PolicyBuilder = class {
     this._def.using = sqlExpr;
     return this;
   }
+  /**
+   * "Rows of THIS table whose owner the caller is a member of" — the membership
+   * pattern, written so it cannot recurse.
+   *
+   * THE TRAP IT EXISTS FOR. Written by hand, membership policies point at each
+   * other: `channels` is visible to members, so its policy reads
+   * `channel_members`; `channel_members` is visible to members, so its policy
+   * reads `channels`. Postgres refuses the pair at query time with `infinite
+   * recursion detected in policy for relation ...`, and the error names the
+   * relation but not the cycle. The way out is asymmetry — the MEMBERSHIP table
+   * is protected by `user_id = auth.uid()` and nothing else, and every other
+   * table subqueries INTO it. That shape was in the platform's own schema and
+   * written down nowhere; a customer recovered it by reading that schema.
+   *
+   * `(select auth.uid())` rather than a bare call: the scalar subquery is
+   * evaluated ONCE per statement instead of per row.
+   *
+   * @example
+   * // channels: visible to members. The membership table gets the simple one.
+   * policy("member_read").for("select").to("authenticated")
+   *   .memberOf("channel_members", "channel_id")
+   * // → id IN (SELECT "channel_id" FROM "channel_members"
+   * //          WHERE "user_id" = (select auth.uid()))
+   */
+  memberOf(membershipTable, foreignKey, options = {}) {
+    if (this._def.using !== null) {
+      throw new Error(
+        `policy(${this._def.name}).memberOf(): this policy already has a using() expression. Write one or the other \u2014 memberOf IS the using expression.`
+      );
+    }
+    const column = options.column ?? "id";
+    const userColumn = options.userColumn ?? "user_id";
+    this._def.using = `${quote(column)} IN (SELECT ${quote(foreignKey)} FROM ${quote(membershipTable)} WHERE ${quote(userColumn)} = (select auth.uid()))`;
+    return this;
+  }
   /** Set the `WITH CHECK (...)` write-validation expression (raw SQL). */
   withCheck(sqlExpr) {
     this._def.withCheck = sqlExpr;
@@ -121,27 +159,81 @@ function defineSchema(input) {
     if (table.checks !== void 0 && table.checks.length > 0) tableDef.checks = table.checks.slice();
     if (table.indexes !== void 0 && table.indexes.length > 0) tableDef.indexes = table.indexes.slice();
     if (table.search !== void 0) {
-      if (table.search.text === void 0 && table.search.vector === void 0) {
-        throw new Error(
-          `table ${String(name)}: search beyan\u0131 bo\u015F \u2014 en az bir kol (text ya da vector) verin, yoksa alan\u0131 hi\xE7 yazmay\u0131n`
-        );
-      }
-      if (table.search.text !== void 0 && table.search.text.length === 0) {
-        throw new Error(`table ${String(name)}: search.text bo\u015F olamaz \u2014 FTS kolu istemiyorsan alan\u0131 hi\xE7 yazma`);
-      }
-      const legs = table.search.vector === void 0 ? [] : Array.isArray(table.search.vector) ? table.search.vector : [table.search.vector];
-      for (const leg of legs) {
-        if (leg.model !== void 0 && (leg.from === void 0 || leg.from.length === 0)) {
-          throw new Error(`table ${String(name)}: search.vector.model beyan edildi ama 'from' yok \u2014 embed kayna\u011F\u0131 kolonlar zorunlu (C-2)`);
+      const s = table.search;
+      if (s.from !== void 0) {
+        if (s.vector !== void 0) {
+          throw new Error(
+            `table ${String(name)}: search beyan\u0131nda tek bi\xE7im kullan\u0131n \u2014 'from' (yeni) ile 'vector' (eski) birlikte olamaz`
+          );
+        }
+        if (s.from.length === 0) {
+          throw new Error(`table ${String(name)}: search.from bo\u015F olamaz`);
+        }
+        if (s.model === void 0) {
+          throw new Error(
+            `table ${String(name)}: search.from model'siz anlams\u0131z \u2014 auto-embed i\xE7in model verin (BYO i\xE7in eski 'vector' bi\xE7imini kullan\u0131n)`
+          );
         }
-        if (leg.model === void 0 && leg.from !== void 0) {
-          throw new Error(`table ${String(name)}: search.vector.from model'siz anlams\u0131z \u2014 auto-embed i\xE7in model verin`);
+        if (Array.isArray(s.text) && s.text.length === 0) {
+          throw new Error(`table ${String(name)}: search.text bo\u015F dizi olamaz \u2014 FTS istemiyorsan text: false yaz\u0131n`);
         }
+      } else {
+        if (typeof s.text === "boolean") {
+          throw new Error(`table ${String(name)}: text:${String(s.text)} yaln\u0131z yeni bi\xE7imde ('from' ile) ge\xE7erli`);
+        }
+        if (s.text === void 0 && s.vector === void 0) {
+          throw new Error(
+            `table ${String(name)}: search beyan\u0131 bo\u015F \u2014 en az bir kol (text ya da vector) verin, yoksa alan\u0131 hi\xE7 yazmay\u0131n`
+          );
+        }
+        if (s.text !== void 0 && s.text.length === 0) {
+          throw new Error(`table ${String(name)}: search.text bo\u015F olamaz \u2014 FTS kolu istemiyorsan alan\u0131 hi\xE7 yazma`);
+        }
+        const legs = s.vector === void 0 ? [] : Array.isArray(s.vector) ? s.vector : [s.vector];
+        for (const leg of legs) {
+          if (leg.model !== void 0 && (leg.from === void 0 || leg.from.length === 0)) {
+            throw new Error(`table ${String(name)}: search.vector.model beyan edildi ama 'from' yok \u2014 embed kayna\u011F\u0131 kolonlar zorunlu (C-2)`);
+          }
+          if (leg.model === void 0 && leg.from !== void 0) {
+            throw new Error(`table ${String(name)}: search.vector.from model'siz anlams\u0131z \u2014 auto-embed i\xE7in model verin`);
+          }
+        }
+      }
+      tableDef.search = s;
+    }
+    if (table.memory !== void 0) {
+      if (table.memory.from.length === 0) {
+        throw new Error(`table ${String(name)}: memory.from bo\u015F olamaz`);
       }
-      tableDef.search = table.search;
+      tableDef.memory = table.memory;
     }
     tables[name] = tableDef;
   }
+  for (const [name, def] of Object.entries(tables)) {
+    const m = def.memory;
+    if (m === void 0) continue;
+    const target = Object.values(tables).find((t) => t.name === m.into);
+    if (target === void 0) {
+      throw new Error(`table ${name}: memory.into "${m.into}" \u015Femada declared de\u011Fil`);
+    }
+    const subject = m.subject ?? "owner";
+    if (!(subject in def.columns)) {
+      throw new Error(`table ${name}: memory.subject "${subject}" kolonu kaynak tabloda yok`);
+    }
+    if (!(subject in target.columns)) {
+      throw new Error(`table ${name}: memory.subject "${subject}" kolonu hedef "${m.into}" tablosunda yok`);
+    }
+    const factCol = target.columns["fact"];
+    const factDef = factCol !== void 0 && "_def" in factCol ? factCol._def : factCol;
+    if (factDef === void 0 || factDef.type !== "text") {
+      throw new Error(`table ${name}: memory.into "${m.into}" tablosunda "fact" (text) kolonu zorunlu`);
+    }
+    for (const c of m.from) {
+      if (!(c in def.columns)) {
+        throw new Error(`table ${name}: memory.from kolonu "${c}" kaynak tabloda yok`);
+      }
+    }
+  }
   const extensions = [...new Set(input.extensions ?? [])];
   return { tables, extensions };
 }
@@ -235,6 +327,21 @@ var ColumnBuilder = class _ColumnBuilder {
     this._def.defaultNow = true;
     return new _ColumnBuilder(this._def.type, this._def);
   }
+  /**
+   * The DATABASE assigns this column's value — a trigger, a rule, an identity.
+   *
+   * The column becomes optional on INSERT (the author has nothing to send) while
+   * the DDL stays free of a DEFAULT this schema would not honour. It is NOT
+   * `default()`: that declares a value the schema promises to write.
+   *
+   * Naming: deliberately not `generated()`. Postgres has GENERATED columns and
+   * they are a different thing; borrowing the word would send a reader — or a
+   * model writing a schema — to the wrong feature.
+   */
+  dbAssigned() {
+    this._def.dbAssigned = true;
+    return new _ColumnBuilder(this._def.type, this._def);
+  }
   /** Add a foreign key reference. */
   /**
    * Declares that this column used to be called `previous`.
@@ -369,6 +476,9 @@ var openai = {
       ...opts?.dimensions !== void 0 ? { dimensions: opts.dimensions } : {},
       ...opts?.baseURL !== void 0 ? { baseURL: opts.baseURL } : {}
     };
+  },
+  chat(model) {
+    return { provider: "openai", model };
   }
 };
 
@@ -611,6 +721,19 @@ var TxPlanBuilder = class {
         }
         return this.push({ op: "insert", table: name, values: encoded }, `${name}.insert()`);
       },
+      upsert: (values, options) => {
+        const encoded = encodeMap(values, false);
+        if (Object.keys(encoded).length === 0) {
+          throw new TxPlanError(`${name}.upsert() needs at least one column`);
+        }
+        if (options.onConflict.length === 0) {
+          throw new TxPlanError(`${name}.upsert() needs at least one onConflict column`);
+        }
+        return this.push(
+          { op: "upsert", table: name, values: encoded, onConflict: options.onConflict },
+          `${name}.upsert()`
+        );
+      },
       insertMany: (rows) => {
         if (rows.length === 0) {
           return new TxRowsImpl(this, SKIPPED_OP, `${name}.insertMany()`);
@@ -784,10 +907,11 @@ function translateRejection(err, builder) {
 function makeTypedTable(name, raw2) {
   return {
     insert: (data) => raw2.insert(name, data),
+    upsert: (data, opts) => raw2.upsert(name, data, opts),
     update: (id, data) => raw2.update(name, id, data),
     delete: (id) => raw2.delete(name, id),
     findById: (id) => raw2.findById(name, id),
-    findMany: (query) => raw2.findMany(name, query)
+    findMany: (query, opts) => raw2.findMany(name, query, opts)
   };
 }
 function makeTypedDB(schema, raw2) {