@digimuza/saas-core 0.0.2

package/dist/db/schema/billing.d.ts.map

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

package/dist/db/schema/billing.js

@@ -0,0 +1,223 @@
+import { relations, sql } from "drizzle-orm";
+import { bigint, boolean, index, integer, jsonb, pgEnum, pgTable, text, timestamp, unique, uniqueIndex, uuid, } from "drizzle-orm/pg-core";
+import { primaryId, timestamps } from "./_shared.js";
+import { workspaces } from "./workspaces.js";
+/**
+ * Provider-independent subscription lifecycle.
+ *
+ * A fixed vocabulary rather than whatever the payment provider happens to call
+ * these states: the adapter maps provider statuses onto this list, so switching
+ * provider does not ripple into application queries.
+ */
+export const subscriptionStatus = pgEnum("subscription_status", [
+    "trialing",
+    "active",
+    "past_due",
+    "paused",
+    "canceled",
+    "incomplete",
+]);
+/** Statuses that entitle a workspace to its plan's features. */
+export const ENTITLING_SUBSCRIPTION_STATUSES = ["trialing", "active", "past_due"];
+export const billingInterval = pgEnum("billing_interval", ["month", "year", "one_time"]);
+/**
+ * `feature` entitlements are on/off; `limit` entitlements carry a quota.
+ * Separating them keeps `has()` and `getLimit()` from having to guess.
+ */
+export const entitlementKind = pgEnum("entitlement_kind", ["feature", "limit"]);
+export const billingEventStatus = pgEnum("billing_event_status", [
+    "pending",
+    "processed",
+    "failed",
+    "ignored",
+]);
+/**
+ * A purchasable plan.
+ *
+ * `key` is the stable internal identifier; `provider_price_id` is the provider's.
+ * Application code must reference neither — it asks about entitlements. Plans are
+ * global rather than workspace-scoped: they are the product's catalogue.
+ */
+export const plans = pgTable("plans", {
+    id: primaryId(),
+    key: text("key").notNull().unique(),
+    name: text("name").notNull(),
+    description: text("description"),
+    /** Identifier in the payment provider's catalogue. Null for unbilled plans. */
+    providerPriceId: text("provider_price_id"),
+    /** Minor units (cents), to avoid floating-point money. */
+    amountCents: integer("amount_cents").notNull().default(0),
+    /** ISO 4217, uppercase. */
+    currency: text("currency").notNull().default("EUR"),
+    interval: billingInterval("interval").notNull().default("month"),
+    /** Hidden from the pricing page but still honoured for existing customers. */
+    isActive: boolean("is_active").notNull().default(true),
+    sortOrder: integer("sort_order").notNull().default(0),
+    ...timestamps,
+}, (table) => [index("plans_is_active_idx").on(table.isActive)]);
+/**
+ * What a plan grants: features and limits.
+ *
+ * `limit_value` is null for an unlimited quota, which is deliberately distinct
+ * from a missing row (no entitlement at all) and from zero (explicitly none).
+ */
+export const entitlements = pgTable("entitlements", {
+    id: primaryId(),
+    planId: uuid("plan_id")
+        .notNull()
+        .references(() => plans.id, { onDelete: "cascade" }),
+    key: text("key").notNull(),
+    kind: entitlementKind("kind").notNull(),
+    /** Quota for `kind = 'limit'`. Null means unlimited. */
+    limitValue: bigint("limit_value", { mode: "number" }),
+    ...timestamps,
+}, (table) => [unique("entitlements_plan_id_key_unique").on(table.planId, table.key)]);
+/**
+ * A workspace's identity at the payment provider.
+ *
+ * Workspace-scoped, not user-scoped: the tenant pays, and members come and go.
+ */
+export const billingCustomers = pgTable("billing_customers", {
+    id: primaryId(),
+    workspaceId: uuid("workspace_id")
+        .notNull()
+        .unique()
+        .references(() => workspaces.id, { onDelete: "cascade" }),
+    provider: text("provider").notNull(),
+    providerCustomerId: text("provider_customer_id").notNull(),
+    /** Billing contact, which may differ from any member's profile email. */
+    email: text("email"),
+    ...timestamps,
+}, (table) => [
+    unique("billing_customers_provider_customer_unique").on(table.provider, table.providerCustomerId),
+]);
+export const subscriptions = pgTable("subscriptions", {
+    id: primaryId(),
+    workspaceId: uuid("workspace_id")
+        .notNull()
+        .references(() => workspaces.id, { onDelete: "cascade" }),
+    billingCustomerId: uuid("billing_customer_id")
+        .notNull()
+        .references(() => billingCustomers.id, { onDelete: "cascade" }),
+    /**
+     * Restrict, not cascade: deleting a plan that customers are still paying for
+     * would silently strip their entitlements. Retire the plan with
+     * `is_active = false` instead.
+     */
+    planId: uuid("plan_id")
+        .notNull()
+        .references(() => plans.id, { onDelete: "restrict" }),
+    provider: text("provider").notNull(),
+    providerSubscriptionId: text("provider_subscription_id").notNull(),
+    status: subscriptionStatus("status").notNull(),
+    currentPeriodStart: timestamp("current_period_start", { withTimezone: true, mode: "date" }),
+    currentPeriodEnd: timestamp("current_period_end", { withTimezone: true, mode: "date" }),
+    cancelAtPeriodEnd: boolean("cancel_at_period_end").notNull().default(false),
+    canceledAt: timestamp("canceled_at", { withTimezone: true, mode: "date" }),
+    trialEndsAt: timestamp("trial_ends_at", { withTimezone: true, mode: "date" }),
+    ...timestamps,
+}, (table) => [
+    unique("subscriptions_provider_subscription_unique").on(table.provider, table.providerSubscriptionId),
+    index("subscriptions_workspace_id_idx").on(table.workspaceId),
+    /**
+     * At most one live subscription per workspace.
+     *
+     * Without this, two overlapping subscriptions would make "which plan is this
+     * workspace on?" ambiguous, and entitlement resolution would depend on row
+     * order. Cancelled and incomplete rows are excluded so history is kept.
+     */
+    uniqueIndex("subscriptions_one_live_per_workspace_idx")
+        .on(table.workspaceId)
+        .where(sql `${table.status} in ('trialing', 'active', 'past_due')`),
+]);
+/**
+ * Every webhook the provider has sent us.
+ *
+ * `(provider, provider_event_id)` is unique, which is the whole idempotency
+ * mechanism: providers retry aggressively and at-least-once delivery means the
+ * same event will arrive twice. The insert is what claims an event for
+ * processing, so a duplicate is rejected by the database rather than by a
+ * check-then-act race.
+ *
+ * The raw payload is retained so an event whose handler failed can be replayed
+ * without asking the provider to resend it.
+ */
+export const billingEvents = pgTable("billing_events", {
+    id: primaryId(),
+    provider: text("provider").notNull(),
+    providerEventId: text("provider_event_id").notNull(),
+    type: text("type").notNull(),
+    payload: jsonb("payload").notNull(),
+    status: billingEventStatus("status").notNull().default("pending"),
+    processedAt: timestamp("processed_at", { withTimezone: true, mode: "date" }),
+    /** Failure detail for replay. Never contains provider credentials. */
+    error: text("error"),
+    ...timestamps,
+}, (table) => [
+    unique("billing_events_provider_event_unique").on(table.provider, table.providerEventId),
+    index("billing_events_status_idx").on(table.status),
+]);
+/**
+ * Metered consumption, for limit entitlements.
+ *
+ * Append-only: a running counter would lose the ability to attribute usage to a
+ * billing period, and would make concurrent increments a contention point.
+ * Consumption is summed over the current period at read time.
+ */
+export const usageRecords = pgTable("usage_records", {
+    id: primaryId(),
+    workspaceId: uuid("workspace_id")
+        .notNull()
+        .references(() => workspaces.id, { onDelete: "cascade" }),
+    /** Matches an entitlement key of kind `limit`, e.g. `"ai_generations"`. */
+    key: text("key").notNull(),
+    quantity: integer("quantity").notNull().default(1),
+    occurredAt: timestamp("occurred_at", { withTimezone: true, mode: "date" })
+        .notNull()
+        .defaultNow(),
+    /**
+     * Caller-supplied deduplication key. A retried request that reuses it is
+     * counted once, so a network retry does not consume a customer's quota twice.
+     */
+    idempotencyKey: text("idempotency_key"),
+    createdAt: timestamp("created_at", { withTimezone: true, mode: "date" })
+        .notNull()
+        .defaultNow(),
+}, (table) => [
+    index("usage_records_workspace_key_occurred_idx").on(table.workspaceId, table.key, table.occurredAt),
+    uniqueIndex("usage_records_idempotency_idx")
+        .on(table.workspaceId, table.key, table.idempotencyKey)
+        .where(sql `${table.idempotencyKey} is not null`),
+]);
+export const plansRelations = relations(plans, ({ many }) => ({
+    entitlements: many(entitlements),
+    subscriptions: many(subscriptions),
+}));
+export const entitlementsRelations = relations(entitlements, ({ one }) => ({
+    plan: one(plans, { fields: [entitlements.planId], references: [plans.id] }),
+}));
+export const billingCustomersRelations = relations(billingCustomers, ({ one, many }) => ({
+    workspace: one(workspaces, {
+        fields: [billingCustomers.workspaceId],
+        references: [workspaces.id],
+    }),
+    subscriptions: many(subscriptions),
+}));
+export const subscriptionsRelations = relations(subscriptions, ({ one }) => ({
+    workspace: one(workspaces, {
+        fields: [subscriptions.workspaceId],
+        references: [workspaces.id],
+    }),
+    customer: one(billingCustomers, {
+        fields: [subscriptions.billingCustomerId],
+        references: [billingCustomers.id],
+    }),
+    plan: one(plans, { fields: [subscriptions.planId], references: [plans.id] }),
+}));
+export const usageRecordsRelations = relations(usageRecords, ({ one }) => ({
+    workspace: one(workspaces, {
+        fields: [usageRecords.workspaceId],
+        references: [workspaces.id],
+    }),
+}));
+//# sourceMappingURL=billing.js.map

package/dist/db/schema/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../../src/db/schema/billing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,MAAM,EACN,OAAO,EACP,KAAK,EACL,OAAO,EACP,KAAK,EACL,MAAM,EACN,OAAO,EACP,IAAI,EACJ,SAAS,EACT,MAAM,EACN,WAAW,EACX,IAAI,GACL,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,qBAAqB,EAAE;IAC9D,UAAU;IACV,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,UAAU;IACV,YAAY;CACb,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAE3F,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,sBAAsB,EAAE;IAC/D,SAAS;IACT,WAAW;IACX,QAAQ;IACR,SAAS;CACV,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAC1B,OAAO,EACP;IACE,EAAE,EAAE,SAAS,EAAE;IACf,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;IACnC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;IAEhC,+EAA+E;IAC/E,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAE1C,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,2BAA2B;IAC3B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnD,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IAEhE,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACtD,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAErD,GAAG,UAAU;CACd,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAC7D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CACjC,cAAc,EACd;IACE,EAAE,EAAE,SAAS,EAAE;IACf,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;SACpB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAEtD,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;IAC1B,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAEvC,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAErD,GAAG,UAAU;CACd,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CACnF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CACrC,mBAAmB,EACnB;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,MAAM,EAAE;SACR,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAE3D,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACpC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC,OAAO,EAAE;IAE1D,yEAAyE;IACzE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;IAEpB,GAAG,UAAU;CACd,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,MAAM,CAAC,4CAA4C,CAAC,CAAC,EAAE,CACrD,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,kBAAkB,CACzB;CACF,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAClC,eAAe,EACf;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC3D,iBAAiB,EAAE,IAAI,CAAC,qBAAqB,CAAC;SAC3C,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjE;;;;OAIG;IACH,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;SACpB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvD,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACpC,sBAAsB,EAAE,IAAI,CAAC,0BAA0B,CAAC,CAAC,OAAO,EAAE;IAElE,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAE9C,kBAAkB,EAAE,SAAS,CAAC,sBAAsB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3F,gBAAgB,EAAE,SAAS,CAAC,oBAAoB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvF,iBAAiB,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3E,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1E,WAAW,EAAE,SAAS,CAAC,eAAe,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAE7E,GAAG,UAAU;CACd,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,MAAM,CAAC,4CAA4C,CAAC,CAAC,EAAE,CACrD,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,sBAAsB,CAC7B;IACD,KAAK,CAAC,gCAAgC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;IAE7D;;;;;;OAMG;IACH,WAAW,CAAC,0CAA0C,CAAC;SACpD,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;SACrB,KAAK,CAAC,GAAG,CAAA,GAAG,KAAK,CAAC,MAAM,wCAAwC,CAAC;CACrE,CACF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAClC,gBAAgB,EAChB;IACE,EAAE,EAAE,SAAS,EAAE;IACf,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACpC,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE;IAEpD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAEnC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACjE,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5E,sEAAsE;IACtE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;IAEpB,GAAG,UAAU;CACd,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,MAAM,CAAC,sCAAsC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,eAAe,CAAC;IACxF,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;CACpD,CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CACjC,eAAe,EACf;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAE3D,2EAA2E;IAC3E,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;IAC1B,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACvE,OAAO,EAAE;SACT,UAAU,EAAE;IAEf;;;OAGG;IACH,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC;IAEvC,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACrE,OAAO,EAAE;SACT,UAAU,EAAE;CAChB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,0CAA0C,CAAC,CAAC,EAAE,CAClD,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,GAAG,EACT,KAAK,CAAC,UAAU,CACjB;IACD,WAAW,CAAC,+BAA+B,CAAC;SACzC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,cAAc,CAAC;SACtD,KAAK,CAAC,GAAG,CAAA,GAAG,KAAK,CAAC,cAAc,cAAc,CAAC;CACnD,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5D,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC;IAChC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC;CACnC,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;CAC5E,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC,gBAAgB,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACvF,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE;QACzB,MAAM,EAAE,CAAC,gBAAgB,CAAC,WAAW,CAAC;QACtC,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;KAC5B,CAAC;IACF,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC;CACnC,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3E,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE;QACzB,MAAM,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC;QACnC,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;KAC5B,CAAC;IACF,QAAQ,EAAE,GAAG,CAAC,gBAAgB,EAAE;QAC9B,MAAM,EAAE,CAAC,aAAa,CAAC,iBAAiB,CAAC;QACzC,UAAU,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;KAClC,CAAC;IACF,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;CAC7E,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE;QACzB,MAAM,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC;QAClC,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;KAC5B,CAAC;CACH,CAAC,CAAC,CAAC"}

package/dist/db/schema/events.d.ts

@@ -0,0 +1,161 @@
+/**
+ * The durable record of something that happened.
+ *
+ * Events are the substrate for realtime delivery, notifications, audit logs,
+ * outgoing webhooks and durable jobs. Persisting first and fanning out second is
+ * what makes those consumers possible: an event that existed only in memory
+ * could not be replayed, audited, or delivered to a client that was offline.
+ *
+ * Append-only. There is no `updated_at`, because an event is a statement about
+ * the past and revising one would make every derived record untrustworthy.
+ */
+export declare const events: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "events";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "type";
+            tableName: "events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        actorUserId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_user_id";
+            tableName: "events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        data: import("drizzle-orm/pg-core").PgColumn<{
+            name: "data";
+            tableName: "events";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        occurredAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "occurred_at";
+            tableName: "events";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "events";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        idempotencyKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "idempotency_key";
+            tableName: "events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;
+export declare const eventsRelations: import("drizzle-orm").Relations<"events", {
+    workspace: import("drizzle-orm").One<"workspaces", false>;
+    actor: import("drizzle-orm").One<"users", false>;
+}>;
+export type EventRow = typeof events.$inferSelect;
+export type NewEventRow = typeof events.$inferInsert;
+//# sourceMappingURL=events.d.ts.map

package/dist/db/schema/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/db/schema/events.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DlB,CAAC;AAEF,eAAO,MAAM,eAAe;;;EAGzB,CAAC;AAEJ,MAAM,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,YAAY,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,YAAY,CAAC"}

package/dist/db/schema/events.js

@@ -0,0 +1,66 @@
+import { relations, sql } from "drizzle-orm";
+import { index, jsonb, pgTable, text, timestamp, uniqueIndex, uuid } from "drizzle-orm/pg-core";
+import { primaryId } from "./_shared.js";
+import { users } from "./users.js";
+import { workspaces } from "./workspaces.js";
+/**
+ * The durable record of something that happened.
+ *
+ * Events are the substrate for realtime delivery, notifications, audit logs,
+ * outgoing webhooks and durable jobs. Persisting first and fanning out second is
+ * what makes those consumers possible: an event that existed only in memory
+ * could not be replayed, audited, or delivered to a client that was offline.
+ *
+ * Append-only. There is no `updated_at`, because an event is a statement about
+ * the past and revising one would make every derived record untrustworthy.
+ */
+export const events = pgTable("events", {
+    id: primaryId(),
+    /** Registry key, e.g. `"workspace.member.created"`. */
+    type: text("type").notNull(),
+    /**
+     * Tenant the event belongs to. Null for platform-wide events that precede
+     * any workspace, such as a user being provisioned.
+     */
+    workspaceId: uuid("workspace_id").references(() => workspaces.id, { onDelete: "cascade" }),
+    /**
+     * Who caused it. Null for events with no human actor — a webhook, a
+     * scheduled job. Set null rather than cascade: deleting a user must not
+     * rewrite history.
+     */
+    actorUserId: uuid("actor_user_id").references(() => users.id, { onDelete: "set null" }),
+    /** Payload, validated against the registry schema for `type` before insert. */
+    data: jsonb("data").notNull(),
+    /**
+     * When it happened, which is not always when it was recorded — a webhook may
+     * report an event minutes after the fact.
+     */
+    occurredAt: timestamp("occurred_at", { withTimezone: true, mode: "date" })
+        .notNull()
+        .defaultNow(),
+    createdAt: timestamp("created_at", { withTimezone: true, mode: "date" }).notNull().defaultNow(),
+    /**
+     * Caller-supplied deduplication key, so a retried operation records the event
+     * once. Scoped per type: two different event types may legitimately share a
+     * key derived from the same request.
+     */
+    idempotencyKey: text("idempotency_key"),
+}, (table) => [
+    /**
+     * "What happened in this workspace lately" — the query every activity feed
+     * and audit view runs. Descending so the newest rows come first without a
+     * sort.
+     */
+    index("events_workspace_occurred_idx").on(table.workspaceId, table.occurredAt.desc()),
+    /** "Every occurrence of this event type", for backfills and diagnostics. */
+    index("events_type_occurred_idx").on(table.type, table.occurredAt.desc()),
+    index("events_actor_idx").on(table.actorUserId),
+    uniqueIndex("events_idempotency_idx")
+        .on(table.type, table.idempotencyKey)
+        .where(sql `${table.idempotencyKey} is not null`),
+]);
+export const eventsRelations = relations(events, ({ one }) => ({
+    workspace: one(workspaces, { fields: [events.workspaceId], references: [workspaces.id] }),
+    actor: one(users, { fields: [events.actorUserId], references: [users.id] }),
+}));
+//# sourceMappingURL=events.js.map

package/dist/db/schema/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/db/schema/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAC3B,QAAQ,EACR;IACE,EAAE,EAAE,SAAS,EAAE;IAEf,uDAAuD;IACvD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAE5B;;;OAGG;IACH,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAE1F;;;;OAIG;IACH,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvF,+EAA+E;IAC/E,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAE7B;;;OAGG;IACH,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACvE,OAAO,EAAE;SACT,UAAU,EAAE;IAEf,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IAE/F;;;;OAIG;IACH,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC;CACxC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT;;;;OAIG;IACH,KAAK,CAAC,+BAA+B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAErF,4EAA4E;IAC5E,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAEzE,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;IAE/C,WAAW,CAAC,wBAAwB,CAAC;SAClC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC;SACpC,KAAK,CAAC,GAAG,CAAA,GAAG,KAAK,CAAC,cAAc,cAAc,CAAC;CACnD,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7D,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;CAC5E,CAAC,CAAC,CAAC"}