@fonderie/billing 1.1.1 → 1.1.2

package/dist/migrations/sql/001_billing.sql

@@ -0,0 +1,38 @@
+CREATE TABLE IF NOT EXISTS fonderie_plans (
+  id               UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name             TEXT NOT NULL UNIQUE,
+  seats            INT,
+  trial_days       INT NOT NULL DEFAULT 0,
+  monthly_amount   INT,
+  monthly_price_id TEXT,
+  yearly_amount    INT,
+  yearly_price_id  TEXT,
+  active           BOOLEAN NOT NULL DEFAULT true,
+  created_at       TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE TABLE IF NOT EXISTS fonderie_subscriptions (
+  id                       UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  workspace_id             UUID NOT NULL UNIQUE,
+  plan                     TEXT NOT NULL,
+  interval                 TEXT NOT NULL DEFAULT 'month',
+  status                   TEXT NOT NULL DEFAULT 'incomplete',
+  provider_customer_id     TEXT,
+  provider_subscription_id TEXT,
+  current_period_start     TIMESTAMPTZ,
+  current_period_end       TIMESTAMPTZ,
+  cancel_at_period_end     BOOLEAN NOT NULL DEFAULT false,
+  trial_ends_at            TIMESTAMPTZ,
+  created_at               TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE TABLE IF NOT EXISTS fonderie_usage_records (
+  id           UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  workspace_id UUID NOT NULL,
+  metric       TEXT NOT NULL,
+  quantity     INT NOT NULL DEFAULT 1,
+  recorded_at  TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS fonderie_usage_records_workspace_metric_idx
+  ON fonderie_usage_records (workspace_id, metric, recorded_at);

package/dist/migrations/sql/002_billing_plan_fields.sql

@@ -0,0 +1,5 @@
+ALTER TABLE fonderie_plans
+  ADD COLUMN IF NOT EXISTS description TEXT,
+  ADD COLUMN IF NOT EXISTS tier        INT  NOT NULL DEFAULT 0,
+  ADD COLUMN IF NOT EXISTS features    JSONB NOT NULL DEFAULT '[]',
+  ADD COLUMN IF NOT EXISTS metadata    JSONB NOT NULL DEFAULT '{}';

package/dist/migrations/sql/003_drop_limits.sql

@@ -0,0 +1 @@
+ALTER TABLE fonderie_plans DROP COLUMN IF EXISTS limits;

package/dist/migrations/sql/004_polymorphic_subscribers.sql

@@ -0,0 +1,49 @@
+-- fonderie_subscriptions: replace workspace_id with polymorphic subscriber
+ALTER TABLE fonderie_subscriptions
+  ADD COLUMN subscriber_type TEXT,
+  ADD COLUMN subscriber_id   UUID;
+
+UPDATE fonderie_subscriptions
+  SET subscriber_type = 'workspace',
+      subscriber_id   = workspace_id;
+
+ALTER TABLE fonderie_subscriptions
+  ALTER COLUMN subscriber_type SET NOT NULL,
+  ALTER COLUMN subscriber_id   SET NOT NULL;
+
+ALTER TABLE fonderie_subscriptions
+  DROP CONSTRAINT fonderie_subscriptions_workspace_id_key;
+
+ALTER TABLE fonderie_subscriptions
+  DROP COLUMN workspace_id;
+
+ALTER TABLE fonderie_subscriptions
+  ADD CONSTRAINT fonderie_subscriptions_subscriber_type_check
+    CHECK (subscriber_type IN ('user', 'workspace')),
+  ADD CONSTRAINT fonderie_subscriptions_subscriber_unique
+    UNIQUE (subscriber_type, subscriber_id);
+
+-- fonderie_usage_records: replace workspace_id with polymorphic subscriber
+ALTER TABLE fonderie_usage_records
+  ADD COLUMN subscriber_type TEXT,
+  ADD COLUMN subscriber_id   UUID;
+
+UPDATE fonderie_usage_records
+  SET subscriber_type = 'workspace',
+      subscriber_id   = workspace_id;
+
+ALTER TABLE fonderie_usage_records
+  ALTER COLUMN subscriber_type SET NOT NULL,
+  ALTER COLUMN subscriber_id   SET NOT NULL;
+
+ALTER TABLE fonderie_usage_records
+  DROP COLUMN workspace_id;
+
+ALTER TABLE fonderie_usage_records
+  ADD CONSTRAINT fonderie_usage_records_subscriber_type_check
+    CHECK (subscriber_type IN ('user', 'workspace'));
+
+DROP INDEX IF EXISTS fonderie_usage_records_workspace_metric_idx;
+
+CREATE INDEX fonderie_usage_records_subscriber_metric_idx
+  ON fonderie_usage_records (subscriber_type, subscriber_id, metric, recorded_at);

package/dist/migrations/sql/005_billing_notifications.sql

@@ -0,0 +1,13 @@
+-- Tracks which threshold notifications have been sent per subscriber/key/window.
+-- Prevents duplicate emails when a subscriber hovers around a threshold.
+CREATE TABLE IF NOT EXISTS fonderie_billing_notifications (
+	id              UUID        PRIMARY KEY DEFAULT gen_random_uuid(),
+	subscriber_type TEXT        NOT NULL,
+	subscriber_id   UUID        NOT NULL,
+	policy_key      TEXT        NOT NULL,
+	notification    TEXT        NOT NULL,   -- 'warning' | 'reached' | 'blocked'
+	window_key      TEXT        NOT NULL,   -- e.g. '2026-05-13' for a 1-day window
+	created_at      TIMESTAMPTZ NOT NULL DEFAULT now(),
+	CONSTRAINT fonderie_billing_notifications_unique
+		UNIQUE (subscriber_type, subscriber_id, policy_key, notification, window_key)
+);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fonderie/billing",
-	"version": "1.1.1",
+	"version": "1.1.2",
 	"description": "SaaS billing in one module — config-driven plan catalogue, Stripe subscriptions, polymorphic user and workspace billing surfaces, usage metering, and webhook handling.",
 	"keywords": [
 		"fonderie-js",