@fayz-ai/db 0.1.1 → 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Faya Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @fayz-ai/db
+
+> The shared Drizzle spine that every Fayz plugin schema composes with.
+
+[![npm](https://img.shields.io/npm/v/@fayz-ai/db.svg)](https://www.npmjs.com/package/@fayz-ai/db)
+[![license](https://img.shields.io/npm/l/@fayz-ai/db.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)
+
+**Status:** beta — published to npm and used across Fayz dogfood apps. Pre-1.0: minor APIs may change before 1.0.
+
+When apps are composed from plugins, their data models have to compose too. `@fayz-ai/db` is the schema spine: a small set of canonical Drizzle tables — tenants, people, orders, appointments, products — plus the column helpers (tenant id, timestamps) that plugin schemas build on. Every plugin references the same spine, so a CRM's clients and an agenda's appointments agree on what a person and a tenant are.
+
+It also re-exports `drizzle-orm/pg-core` so the whole stack runs on one Drizzle instance — apps compose their own tables, the spine refs, and plugin schemas without the dual-copy `PgColumn` type clashes you get from mismatched drizzle-orm versions.
+
+## What's inside
+- **Spine tables** — `tenants`, `people`, `orders`, `appointments`, `products`, `orderItems` (Ring 0 references plugins point at, in `public`)
+- **Column helpers** — `tenantId`, `timestamps`, `createdAt`
+- **Re-exported pg-core** — the full `drizzle-orm/pg-core` builder surface, so every package shares one drizzle-orm instance
+
+## Install
+```bash
+npm install @fayz-ai/db
+```
+Depends on `drizzle-orm`. Import pg-core builders from here, not from `drizzle-orm` directly.
+
+## Usage
+```ts
+import { pgTable, text, tenantId, timestamps, people } from '@fayz-ai/db'
+
+export const notes = pgTable('notes', {
+  id: text('id').primaryKey(),
+  personId: text('person_id').references(() => people.id),
+  body: text('body'),
+  tenantId: tenantId(),
+  ...timestamps,
+})
+```
+
+## Part of the Fayz SDK
+The data spine beneath every plugin schema; apps compose it in their own `drizzle.config`.
+
+## Roadmap & contributing
+Built and evolving in the open. See the [Fayz SDK roadmap](../../docs/ROADMAP.md#db) for current gaps, missing features, and good first issues.

package/dist/helpers.d.ts

@@ -1,6 +1,6 @@
 /**
  * Canonical tenant-scoping column: `tenant_id uuid NOT NULL REFERENCES
- * saas_core.tenants(id) ON DELETE CASCADE`. Every Ring-1 plugin table uses this
+ * public.tenants(id) ON DELETE CASCADE`. Every Ring-1 plugin table uses this
  * so tenancy is identical everywhere (and RLS can assume the column exists).
  */
 export declare const tenantId: () => import("drizzle-orm").NotNull<import("drizzle-orm/pg-core").PgUUIDBuilderInitial<"tenant_id">>;

package/dist/index.cjs

@@ -3,23 +3,22 @@
 var pgCore = require('drizzle-orm/pg-core');
 
 // src/index.ts
-var saasCore = pgCore.pgSchema("saas_core");
-var tenants = saasCore.table("tenants", {
+var tenants = pgCore.pgTable("tenants", {
   id: pgCore.uuid("id").primaryKey()
 });
-var persons = saasCore.table("persons", {
+var people = pgCore.pgTable("people", {
   id: pgCore.uuid("id").primaryKey()
 });
-var orders = saasCore.table("orders", {
+var orders = pgCore.pgTable("orders", {
   id: pgCore.uuid("id").primaryKey()
 });
-var bookings = saasCore.table("bookings", {
+var appointments = pgCore.pgTable("appointments", {
   id: pgCore.uuid("id").primaryKey()
 });
-var products = saasCore.table("products", {
+var products = pgCore.pgTable("products", {
   id: pgCore.uuid("id").primaryKey()
 });
-var orderItems = saasCore.table("order_items", {
+var orderItems = pgCore.pgTable("order_items", {
   id: pgCore.uuid("id").primaryKey()
 });
 var tenantId = () => pgCore.uuid("tenant_id").notNull().references(() => tenants.id, { onDelete: "cascade" });
@@ -31,13 +30,12 @@ var createdAt = {
   createdAt: pgCore.timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
 };
 
-exports.bookings = bookings;
+exports.appointments = appointments;
 exports.createdAt = createdAt;
 exports.orderItems = orderItems;
 exports.orders = orders;
-exports.persons = persons;
+exports.people = people;
 exports.products = products;
-exports.saasCore = saasCore;
 exports.tenantId = tenantId;
 exports.tenants = tenants;
 exports.timestamps = timestamps;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schema/spine.ts","../src/helpers.ts"],"names":["pgSchema","uuid","timestamp"],"mappings":";;;;;AAWO,IAAM,QAAA,GAAWA,gBAAS,WAAW;AAErC,IAAM,OAAA,GAAU,QAAA,CAAS,KAAA,CAAM,SAAA,EAAW;AAAA,EAC/C,EAAA,EAAIC,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,OAAA,GAAU,QAAA,CAAS,KAAA,CAAM,SAAA,EAAW;AAAA,EAC/C,EAAA,EAAIA,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,QAAA,EAAU;AAAA,EAC7C,EAAA,EAAIA,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,QAAA,GAAW,QAAA,CAAS,KAAA,CAAM,UAAA,EAAY;AAAA,EACjD,EAAA,EAAIA,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,QAAA,GAAW,QAAA,CAAS,KAAA,CAAM,UAAA,EAAY;AAAA,EACjD,EAAA,EAAIA,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,UAAA,GAAa,QAAA,CAAS,KAAA,CAAM,aAAA,EAAe;AAAA,EACtD,EAAA,EAAIA,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AC3BM,IAAM,QAAA,GAAW,MACtBA,WAAAA,CAAK,WAAW,EACb,OAAA,EAAQ,CACR,UAAA,CAAW,MAAM,OAAA,CAAQ,EAAA,EAAI,EAAE,QAAA,EAAU,WAAW;AAGlD,IAAM,UAAA,GAAa;AAAA,EACxB,SAAA,EAAWC,gBAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA,EAAW;AAAA,EAChF,SAAA,EAAWA,gBAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA;AACvE;AAGO,IAAM,SAAA,GAAY;AAAA,EACvB,SAAA,EAAWA,gBAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA;AACvE","file":"index.cjs","sourcesContent":["import { pgSchema, uuid } from 'drizzle-orm/pg-core'\n\n/**\n * Ring 0 — the saas_core spine, declared as Drizzle *references* only.\n *\n * These tables are owned by the platform (@fayz/saas-core) and already exist in\n * every provisioned project. We declare a minimal shape here purely so plugin\n * tables can express real cross-schema foreign keys in TypeScript. They land in\n * the Drizzle *baseline* snapshot (never re-created), so only the `id` FK target\n * is needed — the live columns are authoritative.\n */\nexport const saasCore = pgSchema('saas_core')\n\nexport const tenants = saasCore.table('tenants', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const persons = saasCore.table('persons', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const orders = saasCore.table('orders', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const bookings = saasCore.table('bookings', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const products = saasCore.table('products', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const orderItems = saasCore.table('order_items', {\n  id: uuid('id').primaryKey(),\n})\n","import { uuid, timestamp } from 'drizzle-orm/pg-core'\nimport { tenants } from './schema/spine'\n\n/**\n * Canonical tenant-scoping column: `tenant_id uuid NOT NULL REFERENCES\n * saas_core.tenants(id) ON DELETE CASCADE`. Every Ring-1 plugin table uses this\n * so tenancy is identical everywhere (and RLS can assume the column exists).\n */\nexport const tenantId = () =>\n  uuid('tenant_id')\n    .notNull()\n    .references(() => tenants.id, { onDelete: 'cascade' })\n\n/** Standard `created_at` / `updated_at` timestamptz pair with `now()` defaults. */\nexport const timestamps = {\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),\n}\n\n/** Just `created_at` (for append-only / event-style tables). */\nexport const createdAt = {\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n}\n"]}
+{"version":3,"sources":["../src/schema/spine.ts","../src/helpers.ts"],"names":["pgTable","uuid","timestamp"],"mappings":";;;;;AAYO,IAAM,OAAA,GAAUA,eAAQ,SAAA,EAAW;AAAA,EACxC,EAAA,EAAIC,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,MAAA,GAASD,eAAQ,QAAA,EAAU;AAAA,EACtC,EAAA,EAAIC,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,MAAA,GAASD,eAAQ,QAAA,EAAU;AAAA,EACtC,EAAA,EAAIC,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,YAAA,GAAeD,eAAQ,cAAA,EAAgB;AAAA,EAClD,EAAA,EAAIC,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,QAAA,GAAWD,eAAQ,UAAA,EAAY;AAAA,EAC1C,EAAA,EAAIC,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,UAAA,GAAaD,eAAQ,aAAA,EAAe;AAAA,EAC/C,EAAA,EAAIC,WAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AC1BM,IAAM,QAAA,GAAW,MACtBA,WAAAA,CAAK,WAAW,EACb,OAAA,EAAQ,CACR,UAAA,CAAW,MAAM,OAAA,CAAQ,EAAA,EAAI,EAAE,QAAA,EAAU,WAAW;AAGlD,IAAM,UAAA,GAAa;AAAA,EACxB,SAAA,EAAWC,gBAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA,EAAW;AAAA,EAChF,SAAA,EAAWA,gBAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA;AACvE;AAGO,IAAM,SAAA,GAAY;AAAA,EACvB,SAAA,EAAWA,gBAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA;AACvE","file":"index.cjs","sourcesContent":["import { pgTable, uuid } from 'drizzle-orm/pg-core'\n\n/**\n * Ring 0 — the core spine, declared as Drizzle *references* only.\n *\n * These tables are owned by the platform (@fayz-ai/saas core) and already exist\n * in every provisioned pool, directly in the `public` schema (industry-pool\n * model — no saas_core schema). We declare a minimal shape here purely so plugin\n * tables can express real foreign keys in TypeScript. They land in the Drizzle\n * *baseline* snapshot (never re-created), so only the `id` FK target is needed —\n * the live columns are authoritative.\n */\nexport const tenants = pgTable('tenants', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const people = pgTable('people', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const orders = pgTable('orders', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const appointments = pgTable('appointments', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const products = pgTable('products', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const orderItems = pgTable('order_items', {\n  id: uuid('id').primaryKey(),\n})\n","import { uuid, timestamp } from 'drizzle-orm/pg-core'\nimport { tenants } from './schema/spine'\n\n/**\n * Canonical tenant-scoping column: `tenant_id uuid NOT NULL REFERENCES\n * public.tenants(id) ON DELETE CASCADE`. Every Ring-1 plugin table uses this\n * so tenancy is identical everywhere (and RLS can assume the column exists).\n */\nexport const tenantId = () =>\n  uuid('tenant_id')\n    .notNull()\n    .references(() => tenants.id, { onDelete: 'cascade' })\n\n/** Standard `created_at` / `updated_at` timestamptz pair with `now()` defaults. */\nexport const timestamps = {\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),\n}\n\n/** Just `created_at` (for append-only / event-style tables). */\nexport const createdAt = {\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n}\n"]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export * from 'drizzle-orm/pg-core';
-export { saasCore, tenants, persons, orders, bookings, products, orderItems } from './schema/spine';
+export { tenants, people, orders, appointments, products, orderItems } from './schema/spine';
 export { tenantId, timestamps, createdAt } from './helpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACnG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -1,24 +1,23 @@
-import { pgSchema, uuid, timestamp } from 'drizzle-orm/pg-core';
+import { pgTable, uuid, timestamp } from 'drizzle-orm/pg-core';
 export * from 'drizzle-orm/pg-core';
 
 // src/index.ts
-var saasCore = pgSchema("saas_core");
-var tenants = saasCore.table("tenants", {
+var tenants = pgTable("tenants", {
   id: uuid("id").primaryKey()
 });
-var persons = saasCore.table("persons", {
+var people = pgTable("people", {
   id: uuid("id").primaryKey()
 });
-var orders = saasCore.table("orders", {
+var orders = pgTable("orders", {
   id: uuid("id").primaryKey()
 });
-var bookings = saasCore.table("bookings", {
+var appointments = pgTable("appointments", {
   id: uuid("id").primaryKey()
 });
-var products = saasCore.table("products", {
+var products = pgTable("products", {
   id: uuid("id").primaryKey()
 });
-var orderItems = saasCore.table("order_items", {
+var orderItems = pgTable("order_items", {
   id: uuid("id").primaryKey()
 });
 var tenantId = () => uuid("tenant_id").notNull().references(() => tenants.id, { onDelete: "cascade" });
@@ -30,6 +29,6 @@ var createdAt = {
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
 };
 
-export { bookings, createdAt, orderItems, orders, persons, products, saasCore, tenantId, tenants, timestamps };
+export { appointments, createdAt, orderItems, orders, people, products, tenantId, tenants, timestamps };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schema/spine.ts","../src/helpers.ts"],"names":["uuid"],"mappings":";;;;AAWO,IAAM,QAAA,GAAW,SAAS,WAAW;AAErC,IAAM,OAAA,GAAU,QAAA,CAAS,KAAA,CAAM,SAAA,EAAW;AAAA,EAC/C,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,OAAA,GAAU,QAAA,CAAS,KAAA,CAAM,SAAA,EAAW;AAAA,EAC/C,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,QAAA,EAAU;AAAA,EAC7C,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,QAAA,GAAW,QAAA,CAAS,KAAA,CAAM,UAAA,EAAY;AAAA,EACjD,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,QAAA,GAAW,QAAA,CAAS,KAAA,CAAM,UAAA,EAAY;AAAA,EACjD,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,UAAA,GAAa,QAAA,CAAS,KAAA,CAAM,aAAA,EAAe;AAAA,EACtD,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AC3BM,IAAM,QAAA,GAAW,MACtBA,IAAAA,CAAK,WAAW,EACb,OAAA,EAAQ,CACR,UAAA,CAAW,MAAM,OAAA,CAAQ,EAAA,EAAI,EAAE,QAAA,EAAU,WAAW;AAGlD,IAAM,UAAA,GAAa;AAAA,EACxB,SAAA,EAAW,SAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA,EAAW;AAAA,EAChF,SAAA,EAAW,SAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA;AACvE;AAGO,IAAM,SAAA,GAAY;AAAA,EACvB,SAAA,EAAW,SAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA;AACvE","file":"index.js","sourcesContent":["import { pgSchema, uuid } from 'drizzle-orm/pg-core'\n\n/**\n * Ring 0 — the saas_core spine, declared as Drizzle *references* only.\n *\n * These tables are owned by the platform (@fayz/saas-core) and already exist in\n * every provisioned project. We declare a minimal shape here purely so plugin\n * tables can express real cross-schema foreign keys in TypeScript. They land in\n * the Drizzle *baseline* snapshot (never re-created), so only the `id` FK target\n * is needed — the live columns are authoritative.\n */\nexport const saasCore = pgSchema('saas_core')\n\nexport const tenants = saasCore.table('tenants', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const persons = saasCore.table('persons', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const orders = saasCore.table('orders', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const bookings = saasCore.table('bookings', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const products = saasCore.table('products', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const orderItems = saasCore.table('order_items', {\n  id: uuid('id').primaryKey(),\n})\n","import { uuid, timestamp } from 'drizzle-orm/pg-core'\nimport { tenants } from './schema/spine'\n\n/**\n * Canonical tenant-scoping column: `tenant_id uuid NOT NULL REFERENCES\n * saas_core.tenants(id) ON DELETE CASCADE`. Every Ring-1 plugin table uses this\n * so tenancy is identical everywhere (and RLS can assume the column exists).\n */\nexport const tenantId = () =>\n  uuid('tenant_id')\n    .notNull()\n    .references(() => tenants.id, { onDelete: 'cascade' })\n\n/** Standard `created_at` / `updated_at` timestamptz pair with `now()` defaults. */\nexport const timestamps = {\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),\n}\n\n/** Just `created_at` (for append-only / event-style tables). */\nexport const createdAt = {\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n}\n"]}
+{"version":3,"sources":["../src/schema/spine.ts","../src/helpers.ts"],"names":["uuid"],"mappings":";;;;AAYO,IAAM,OAAA,GAAU,QAAQ,SAAA,EAAW;AAAA,EACxC,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,MAAA,GAAS,QAAQ,QAAA,EAAU;AAAA,EACtC,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,MAAA,GAAS,QAAQ,QAAA,EAAU;AAAA,EACtC,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,YAAA,GAAe,QAAQ,cAAA,EAAgB;AAAA,EAClD,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,QAAA,GAAW,QAAQ,UAAA,EAAY;AAAA,EAC1C,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AAEM,IAAM,UAAA,GAAa,QAAQ,aAAA,EAAe;AAAA,EAC/C,EAAA,EAAI,IAAA,CAAK,IAAI,CAAA,CAAE,UAAA;AACjB,CAAC;AC1BM,IAAM,QAAA,GAAW,MACtBA,IAAAA,CAAK,WAAW,EACb,OAAA,EAAQ,CACR,UAAA,CAAW,MAAM,OAAA,CAAQ,EAAA,EAAI,EAAE,QAAA,EAAU,WAAW;AAGlD,IAAM,UAAA,GAAa;AAAA,EACxB,SAAA,EAAW,SAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA,EAAW;AAAA,EAChF,SAAA,EAAW,SAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA;AACvE;AAGO,IAAM,SAAA,GAAY;AAAA,EACvB,SAAA,EAAW,SAAA,CAAU,YAAA,EAAc,EAAE,YAAA,EAAc,MAAM,CAAA,CAAE,OAAA,EAAQ,CAAE,UAAA;AACvE","file":"index.js","sourcesContent":["import { pgTable, uuid } from 'drizzle-orm/pg-core'\n\n/**\n * Ring 0 — the core spine, declared as Drizzle *references* only.\n *\n * These tables are owned by the platform (@fayz-ai/saas core) and already exist\n * in every provisioned pool, directly in the `public` schema (industry-pool\n * model — no saas_core schema). We declare a minimal shape here purely so plugin\n * tables can express real foreign keys in TypeScript. They land in the Drizzle\n * *baseline* snapshot (never re-created), so only the `id` FK target is needed —\n * the live columns are authoritative.\n */\nexport const tenants = pgTable('tenants', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const people = pgTable('people', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const orders = pgTable('orders', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const appointments = pgTable('appointments', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const products = pgTable('products', {\n  id: uuid('id').primaryKey(),\n})\n\nexport const orderItems = pgTable('order_items', {\n  id: uuid('id').primaryKey(),\n})\n","import { uuid, timestamp } from 'drizzle-orm/pg-core'\nimport { tenants } from './schema/spine'\n\n/**\n * Canonical tenant-scoping column: `tenant_id uuid NOT NULL REFERENCES\n * public.tenants(id) ON DELETE CASCADE`. Every Ring-1 plugin table uses this\n * so tenancy is identical everywhere (and RLS can assume the column exists).\n */\nexport const tenantId = () =>\n  uuid('tenant_id')\n    .notNull()\n    .references(() => tenants.id, { onDelete: 'cascade' })\n\n/** Standard `created_at` / `updated_at` timestamptz pair with `now()` defaults. */\nexport const timestamps = {\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),\n}\n\n/** Just `created_at` (for append-only / event-style tables). */\nexport const createdAt = {\n  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n}\n"]}

package/dist/schema/spine.d.ts

@@ -1,16 +1,16 @@
 /**
- * Ring 0 — the saas_core spine, declared as Drizzle *references* only.
+ * Ring 0 — the core spine, declared as Drizzle *references* only.
  *
- * These tables are owned by the platform (@fayz/saas-core) and already exist in
- * every provisioned project. We declare a minimal shape here purely so plugin
- * tables can express real cross-schema foreign keys in TypeScript. They land in
- * the Drizzle *baseline* snapshot (never re-created), so only the `id` FK target
- * is needed — the live columns are authoritative.
+ * These tables are owned by the platform (@fayz-ai/saas core) and already exist
+ * in every provisioned pool, directly in the `public` schema (industry-pool
+ * model — no saas_core schema). We declare a minimal shape here purely so plugin
+ * tables can express real foreign keys in TypeScript. They land in the Drizzle
+ * *baseline* snapshot (never re-created), so only the `id` FK target is needed —
+ * the live columns are authoritative.
  */
-export declare const saasCore: import("drizzle-orm/pg-core").PgSchema<"saas_core">;
 export declare const tenants: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "tenants";
-    schema: "saas_core";
+    schema: undefined;
     columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
@@ -32,13 +32,13 @@ export declare const tenants: import("drizzle-orm/pg-core").PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-export declare const persons: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "persons";
-    schema: "saas_core";
+export declare const people: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "people";
+    schema: undefined;
     columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
-            tableName: "persons";
+            tableName: "people";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -58,7 +58,7 @@ export declare const persons: import("drizzle-orm/pg-core").PgTableWithColumns<{
 }>;
 export declare const orders: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "orders";
-    schema: "saas_core";
+    schema: undefined;
     columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
@@ -80,13 +80,13 @@ export declare const orders: import("drizzle-orm/pg-core").PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
-export declare const bookings: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "bookings";
-    schema: "saas_core";
+export declare const appointments: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "appointments";
+    schema: undefined;
     columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
-            tableName: "bookings";
+            tableName: "appointments";
             dataType: "string";
             columnType: "PgUUID";
             data: string;
@@ -106,7 +106,7 @@ export declare const bookings: import("drizzle-orm/pg-core").PgTableWithColumns<
 }>;
 export declare const products: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "products";
-    schema: "saas_core";
+    schema: undefined;
     columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";
@@ -130,7 +130,7 @@ export declare const products: import("drizzle-orm/pg-core").PgTableWithColumns<
 }>;
 export declare const orderItems: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "order_items";
-    schema: "saas_core";
+    schema: undefined;
     columns: {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: "id";

package/dist/schema/spine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spine.d.ts","sourceRoot":"","sources":["../../src/schema/spine.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,qDAAwB,CAAA;AAE7C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;EAElB,CAAA;AAEF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;EAElB,CAAA;AAEF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;EAEjB,CAAA;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;EAEnB,CAAA;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;EAEnB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;EAErB,CAAA"}
+{"version":3,"file":"spine.d.ts","sourceRoot":"","sources":["../../src/schema/spine.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;EAElB,CAAA;AAEF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;EAEjB,CAAA;AAEF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;EAEjB,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;EAEvB,CAAA;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;EAEnB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;EAErB,CAAA"}

package/migrations/0000_legacy_quarantine.sql

@@ -0,0 +1,86 @@
+-- ============================================================================
+-- 0000_legacy_quarantine.sql — pre-convert collision guard (ALL pools)
+--
+-- MUST run BEFORE 000_core_v1_convert.sql. The filename starts `0000_` so it
+-- lexically sorts ahead of `000_core_v1_convert.sql` (the runner orders files
+-- with a plain string sort — verify: ['0000_legacy_quarantine.sql',
+-- '000_core_v1_convert.sql'].sort()).
+--
+-- WHY: the in-place converter moves saas_core.<source> -> public.<target> only
+-- when public.<target> is FREE (guarded on target absence). If a pool already
+-- holds a legacy public.<target> (a bespoke pre-pool table sharing the name),
+-- the move/rename silently no-ops and the live saas_core.<source> is left
+-- behind — then `DROP SCHEMA saas_core CASCADE` would DESTROY it. This file
+-- gets the colliding legacy table out of the way first, into a quarantine
+-- schema, so every source table has a free target to land on.
+--
+-- For EVERY (source -> target) pair the converter touches, if BOTH
+-- saas_core.<source> AND public.<target> exist, move public.<target> into
+-- legacy_pre_pools. The presence of saas_core.<source> proves the convert has
+-- not run yet, so this public.<target> must be a legacy collision (not the
+-- converted core table).
+--
+-- Known real collisions from the 2026-07-14 backups (all covered by the loop):
+--   * creators   — public.subscriptions (4 rows, direct-move pair)
+--   * salon/gphx — public.appointments (0 rows, bookings->appointments rename)
+--   * restaurant — public.orders + public.order_items (0 rows, direct-move pairs)
+--
+-- Idempotent: guarded on saas_core existing; each move guarded on both source
+-- present AND target present; a no-op on fresh pools and on already-converted
+-- pools (saas_core dropped -> early return).
+-- ============================================================================
+
+DO $quarantine$
+DECLARE
+  r record;
+BEGIN
+  -- Only act on pools that still carry the legacy schema (pre-convert).
+  IF NOT EXISTS (SELECT 1 FROM information_schema.schemata WHERE schema_name = 'saas_core') THEN
+    RETURN;
+  END IF;
+
+  -- (source in saas_core) -> (target in public) for every table the converter
+  -- moves. Direct moves keep the name; the three changed entities are renamed
+  -- (persons->people, bookings->appointments, booking_items->appointment_items).
+  -- Mirrors the move list in 000_core_v1_convert.sql exactly.
+  FOR r IN
+    SELECT * FROM (VALUES
+      ('tenants',                'tenants'),
+      ('profiles',               'profiles'),
+      ('tenant_members',         'tenant_members'),
+      ('plans',                  'plans'),
+      ('permissions',            'permissions'),
+      ('role_permissions',       'role_permissions'),
+      ('tenant_role_overrides',  'tenant_role_overrides'),
+      ('invitations',            'invitations'),
+      ('payment_events',         'payment_events'),
+      ('locations',              'locations'),
+      ('location_members',       'location_members'),
+      ('audit_logs',             'audit_logs'),
+      ('subscriptions',          'subscriptions'),
+      ('invoices',               'invoices'),
+      ('notifications',          'notifications'),
+      ('persons',                'people'),
+      ('categories',             'categories'),
+      ('products',               'products'),
+      ('services',               'services'),
+      ('orders',                 'orders'),
+      ('order_items',            'order_items'),
+      ('transactions',           'transactions'),
+      ('bookings',               'appointments'),
+      ('booking_items',          'appointment_items'),
+      ('schedules',              'schedules'),
+      ('sequences',              'sequences'),
+      ('documents',              'documents')
+    ) AS m(source, target)
+  LOOP
+    IF to_regclass('saas_core.' || quote_ident(r.source)) IS NOT NULL
+       AND to_regclass('public.' || quote_ident(r.target)) IS NOT NULL THEN
+      CREATE SCHEMA IF NOT EXISTS legacy_pre_pools;
+      EXECUTE format('ALTER TABLE public.%I SET SCHEMA legacy_pre_pools', r.target);
+      RAISE NOTICE 'legacy_pre_pools: quarantined public.% (collides with the saas_core.% -> public.% move)',
+        r.target, r.source, r.target;
+    END IF;
+  END LOOP;
+END;
+$quarantine$;

package/migrations/0000b_straggler_sweep.sql

@@ -0,0 +1,37 @@
+-- Move any saas_core table the converter does not know about into public,
+-- so the converter's emptiness gate can pass and drop the schema safely.
+-- Found live: salon carries saas_core.tenant_roles (RBAC iteration that only
+-- ever existed there). Runs between 0000_legacy_quarantine and
+-- 000_core_v1_convert ('0000b' < '000_' lexically). Idempotent: no-ops when
+-- saas_core is gone or has no stragglers. A public-name collision aborts —
+-- that case must be quarantined explicitly, never guessed.
+
+DO $sweep$
+DECLARE
+  r record;
+  known text[] := ARRAY[
+    'tenants', 'profiles', 'tenant_members', 'plans', 'permissions',
+    'role_permissions', 'tenant_role_overrides', 'invitations',
+    'payment_events', 'locations', 'location_members', 'audit_logs',
+    'subscriptions', 'invoices', 'notifications',
+    'persons', 'categories', 'products', 'services', 'orders', 'order_items',
+    'transactions', 'bookings', 'booking_items', 'schedules',
+    'sequences', 'documents'
+  ];
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM information_schema.schemata WHERE schema_name = 'saas_core') THEN
+    RETURN;
+  END IF;
+
+  FOR r IN
+    SELECT table_name FROM information_schema.tables
+    WHERE table_schema = 'saas_core' AND table_type = 'BASE TABLE'
+      AND table_name <> ALL (known)
+  LOOP
+    IF to_regclass('public.' || quote_ident(r.table_name)) IS NOT NULL THEN
+      RAISE EXCEPTION 'straggler saas_core.% collides with an existing public table — quarantine it explicitly', r.table_name;
+    END IF;
+    EXECUTE format('ALTER TABLE saas_core.%I SET SCHEMA public', r.table_name);
+    RAISE NOTICE 'straggler moved: saas_core.% -> public', r.table_name;
+  END LOOP;
+END $sweep$;