@usebetterdev/plugin 0.6.0 → 0.7.0

package/dist/config-loader.d.ts

@@ -0,0 +1,23 @@
+import type { BetterConfig } from "./config-types.js";
+/** Thrown when no `better.config.*` file is found in the working directory. */
+export declare class BetterConfigNotFoundError extends Error {
+    readonly name = "BetterConfigNotFoundError";
+    readonly cwd: string;
+    constructor(cwd: string);
+}
+export interface LoadBetterConfigOptions {
+    /** Working directory to search for the config file. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Explicit path to a config file, bypassing discovery. Maps to c12's `configFile` option. */
+    configPath?: string;
+}
+/**
+ * Loads a `better.config.{ts,js,mjs}` file using c12.
+ * Throws {@link BetterConfigNotFoundError} when no config file is found.
+ *
+ * The returned config is **unvalidated**. Pass it through
+ * {@link requireTenantConfig} or {@link requireAuditConfig} to validate
+ * product-specific sections.
+ */
+export declare function loadBetterConfig(options?: LoadBetterConfigOptions): Promise<BetterConfig>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,+EAA+E;AAC/E,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;CAgBxB;AAED,MAAM,WAAW,uBAAuB;IACtC,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,YAAY,CAAC,CAsBvB"}

package/dist/config-types.d.ts

@@ -0,0 +1,2 @@
+export type { TelemetryConfig, PathResolverConfig, SubdomainResolverConfig, StaticJwtResolverConfig, StaticTenantResolverConfig, BetterTenantStaticConfig, RetentionPolicy, BetterAuditStaticConfig, StaticMagicLinkConfig, StaticConsoleSessionConfig, BetterConsoleStaticConfig, BetterConfig, } from "@usebetterdev/contract/config-types";
+//# sourceMappingURL=config-types.d.ts.map

package/dist/config-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../src/config-types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,GACb,MAAM,qCAAqC,CAAC"}

package/dist/config-validation.d.ts

@@ -0,0 +1,19 @@
+import type { BetterConfig, BetterTenantStaticConfig, BetterAuditStaticConfig } from "./config-types.js";
+/** Thrown when a config section fails validation. */
+export declare class ConfigValidationError extends Error {
+    readonly name = "ConfigValidationError";
+    readonly field: string;
+    constructor(field: string, message: string);
+}
+/**
+ * Validates that `config.tenant` exists and its `tenantTables` is a non-empty
+ * array of non-empty strings. Returns the narrowed tenant config.
+ */
+export declare function requireTenantConfig(config: BetterConfig): BetterTenantStaticConfig;
+/**
+ * Validates that `config.audit` exists and its `auditTables` is a non-empty
+ * array of non-empty strings. When `retention` is present, validates `days` is
+ * a positive integer and `tables` (if present) is a non-empty string array.
+ */
+export declare function requireAuditConfig(config: BetterConfig): BetterAuditStaticConfig;
+//# sourceMappingURL=config-validation.d.ts.map

package/dist/config-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validation.d.ts","sourceRoot":"","sources":["../src/config-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,qDAAqD;AACrD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAkB,IAAI,2BAA2B;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI3C;AA4BD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,GACnB,wBAAwB,CAM1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,GACnB,uBAAuB,CAoBzB"}

package/dist/config.cjs

@@ -0,0 +1,142 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/config.ts
+var config_exports = {};
+__export(config_exports, {
+  BetterConfigNotFoundError: () => BetterConfigNotFoundError,
+  ConfigValidationError: () => ConfigValidationError,
+  defineBetterConfig: () => defineBetterConfig,
+  loadBetterConfig: () => loadBetterConfig,
+  requireAuditConfig: () => requireAuditConfig,
+  requireTenantConfig: () => requireTenantConfig
+});
+module.exports = __toCommonJS(config_exports);
+
+// src/define-config.ts
+function defineBetterConfig(config) {
+  return config;
+}
+
+// src/config-loader.ts
+var import_c12 = require("c12");
+var BetterConfigNotFoundError = class extends Error {
+  name = "BetterConfigNotFoundError";
+  cwd;
+  constructor(cwd) {
+    super(
+      [
+        `No better.config.{ts,js,mjs} file found in ${cwd}.`,
+        "",
+        "Create one with:",
+        "",
+        '  import { defineBetterConfig } from "@usebetterdev/plugin/config";',
+        "",
+        "  export default defineBetterConfig({",
+        '    tenant: { tenantTables: ["organizations"] },',
+        "  });"
+      ].join("\n")
+    );
+    this.cwd = cwd;
+  }
+};
+async function loadBetterConfig(options) {
+  const cwd = options?.cwd ?? process.cwd();
+  const configFile = options?.configPath;
+  const result = await (0, import_c12.loadConfig)({
+    name: "better",
+    cwd,
+    ...configFile !== void 0 ? { configFile } : {},
+    rcFile: false,
+    globalRc: false,
+    packageJson: false,
+    dotenv: false
+  });
+  const layers = result.layers ?? [];
+  if (layers.length === 0) {
+    throw new BetterConfigNotFoundError(cwd);
+  }
+  return result.config ?? {};
+}
+
+// src/config-validation.ts
+var ConfigValidationError = class extends Error {
+  name = "ConfigValidationError";
+  field;
+  constructor(field, message) {
+    super(`Config error: "${field}" ${message}`);
+    this.field = field;
+  }
+};
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function validateStringArray(items, fieldName, sectionName) {
+  const qualifiedName = `${sectionName}.${fieldName}`;
+  if (!Array.isArray(items)) {
+    throw new ConfigValidationError(qualifiedName, "must be an array");
+  }
+  if (items.length === 0) {
+    throw new ConfigValidationError(qualifiedName, "must not be empty");
+  }
+  for (const item of items) {
+    if (!isNonEmptyString(item)) {
+      throw new ConfigValidationError(
+        qualifiedName,
+        "entries must be non-empty strings"
+      );
+    }
+  }
+}
+function requireTenantConfig(config) {
+  if (config.tenant === void 0) {
+    throw new ConfigValidationError("tenant", "section is required");
+  }
+  validateStringArray(config.tenant.tenantTables, "tenantTables", "tenant");
+  return config.tenant;
+}
+function requireAuditConfig(config) {
+  if (config.audit === void 0) {
+    throw new ConfigValidationError("audit", "section is required");
+  }
+  validateStringArray(config.audit.auditTables, "auditTables", "audit");
+  if (config.audit.retention !== void 0) {
+    const { days, tables } = config.audit.retention;
+    if (!Number.isInteger(days) || days <= 0) {
+      throw new ConfigValidationError(
+        "audit.retention.days",
+        "must be a positive integer"
+      );
+    }
+    if (tables !== void 0) {
+      validateStringArray(tables, "retention.tables", "audit");
+    }
+  }
+  return config.audit;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BetterConfigNotFoundError,
+  ConfigValidationError,
+  defineBetterConfig,
+  loadBetterConfig,
+  requireAuditConfig,
+  requireTenantConfig
+});
+//# sourceMappingURL=config.cjs.map

package/dist/config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/define-config.ts","../src/config-loader.ts","../src/config-validation.ts"],"sourcesContent":["// ── Config helpers ───────────────────────────────────────────────────────────\n\nexport { defineBetterConfig } from \"./define-config.js\";\n\nexport {\n  loadBetterConfig,\n  BetterConfigNotFoundError,\n} from \"./config-loader.js\";\nexport type { LoadBetterConfigOptions } from \"./config-loader.js\";\n\nexport {\n  requireTenantConfig,\n  requireAuditConfig,\n  ConfigValidationError,\n} from \"./config-validation.js\";\n\n// ── Re-export config types ──────────────────────────────────────────────────\n\nexport type {\n  BetterConfig,\n  BetterTenantStaticConfig,\n  BetterAuditStaticConfig,\n  BetterConsoleStaticConfig,\n  TelemetryConfig,\n  PathResolverConfig,\n  SubdomainResolverConfig,\n  StaticJwtResolverConfig,\n  StaticTenantResolverConfig,\n  RetentionPolicy,\n  StaticMagicLinkConfig,\n  StaticConsoleSessionConfig,\n} from \"./config-types.js\";\n","import type { BetterConfig } from \"./config-types.js\";\n\n/**\n * Identity helper that provides TypeScript autocomplete for `better.config.ts`.\n *\n * ```ts\n * // better.config.ts\n * import { defineBetterConfig } from \"@usebetterdev/plugin/config\";\n *\n * export default defineBetterConfig({\n *   tenant: { tenantTables: [\"organizations\"] },\n * });\n * ```\n */\nexport function defineBetterConfig(config: BetterConfig): BetterConfig {\n  return config;\n}\n","import { loadConfig } from \"c12\";\nimport type { BetterConfig } from \"./config-types.js\";\n\n/** Thrown when no `better.config.*` file is found in the working directory. */\nexport class BetterConfigNotFoundError extends Error {\n  override readonly name = \"BetterConfigNotFoundError\";\n  readonly cwd: string;\n\n  constructor(cwd: string) {\n    super(\n      [\n        `No better.config.{ts,js,mjs} file found in ${cwd}.`,\n        \"\",\n        \"Create one with:\",\n        \"\",\n        '  import { defineBetterConfig } from \"@usebetterdev/plugin/config\";',\n        \"\",\n        \"  export default defineBetterConfig({\",\n        '    tenant: { tenantTables: [\"organizations\"] },',\n        \"  });\",\n      ].join(\"\\n\"),\n    );\n    this.cwd = cwd;\n  }\n}\n\nexport interface LoadBetterConfigOptions {\n  /** Working directory to search for the config file. Defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Explicit path to a config file, bypassing discovery. Maps to c12's `configFile` option. */\n  configPath?: string;\n}\n\n/**\n * Loads a `better.config.{ts,js,mjs}` file using c12.\n * Throws {@link BetterConfigNotFoundError} when no config file is found.\n *\n * The returned config is **unvalidated**. Pass it through\n * {@link requireTenantConfig} or {@link requireAuditConfig} to validate\n * product-specific sections.\n */\nexport async function loadBetterConfig(\n  options?: LoadBetterConfigOptions,\n): Promise<BetterConfig> {\n  const cwd = options?.cwd ?? process.cwd();\n\n  // configPath maps to c12's configFile — spread conditionally to satisfy exactOptionalPropertyTypes\n  const configFile = options?.configPath;\n\n  const result = await loadConfig<BetterConfig>({\n    name: \"better\",\n    cwd,\n    ...(configFile !== undefined ? { configFile } : {}),\n    rcFile: false,\n    globalRc: false,\n    packageJson: false,\n    dotenv: false,\n  });\n\n  const layers = result.layers ?? [];\n  if (layers.length === 0) {\n    throw new BetterConfigNotFoundError(cwd);\n  }\n\n  return result.config ?? {};\n}\n","import type {\n  BetterConfig,\n  BetterTenantStaticConfig,\n  BetterAuditStaticConfig,\n} from \"./config-types.js\";\n\n/** Thrown when a config section fails validation. */\nexport class ConfigValidationError extends Error {\n  override readonly name = \"ConfigValidationError\";\n  readonly field: string;\n\n  constructor(field: string, message: string) {\n    super(`Config error: \"${field}\" ${message}`);\n    this.field = field;\n  }\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\nfunction validateStringArray(\n  items: unknown,\n  fieldName: string,\n  sectionName: string,\n): void {\n  const qualifiedName = `${sectionName}.${fieldName}`;\n  if (!Array.isArray(items)) {\n    throw new ConfigValidationError(qualifiedName, \"must be an array\");\n  }\n  if (items.length === 0) {\n    throw new ConfigValidationError(qualifiedName, \"must not be empty\");\n  }\n  for (const item of items) {\n    if (!isNonEmptyString(item)) {\n      throw new ConfigValidationError(\n        qualifiedName,\n        \"entries must be non-empty strings\",\n      );\n    }\n  }\n}\n\n/**\n * Validates that `config.tenant` exists and its `tenantTables` is a non-empty\n * array of non-empty strings. Returns the narrowed tenant config.\n */\nexport function requireTenantConfig(\n  config: BetterConfig,\n): BetterTenantStaticConfig {\n  if (config.tenant === undefined) {\n    throw new ConfigValidationError(\"tenant\", \"section is required\");\n  }\n  validateStringArray(config.tenant.tenantTables, \"tenantTables\", \"tenant\");\n  return config.tenant;\n}\n\n/**\n * Validates that `config.audit` exists and its `auditTables` is a non-empty\n * array of non-empty strings. When `retention` is present, validates `days` is\n * a positive integer and `tables` (if present) is a non-empty string array.\n */\nexport function requireAuditConfig(\n  config: BetterConfig,\n): BetterAuditStaticConfig {\n  if (config.audit === undefined) {\n    throw new ConfigValidationError(\"audit\", \"section is required\");\n  }\n  validateStringArray(config.audit.auditTables, \"auditTables\", \"audit\");\n\n  if (config.audit.retention !== undefined) {\n    const { days, tables } = config.audit.retention;\n    if (!Number.isInteger(days) || days <= 0) {\n      throw new ConfigValidationError(\n        \"audit.retention.days\",\n        \"must be a positive integer\",\n      );\n    }\n    if (tables !== undefined) {\n      validateStringArray(tables, \"retention.tables\", \"audit\");\n    }\n  }\n\n  return config.audit;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcO,SAAS,mBAAmB,QAAoC;AACrE,SAAO;AACT;;;AChBA,iBAA2B;AAIpB,IAAM,4BAAN,cAAwC,MAAM;AAAA,EACjC,OAAO;AAAA,EAChB;AAAA,EAET,YAAY,KAAa;AACvB;AAAA,MACE;AAAA,QACE,8CAA8C,GAAG;AAAA,QACjD;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,IAAI;AAAA,IACb;AACA,SAAK,MAAM;AAAA,EACb;AACF;AAiBA,eAAsB,iBACpB,SACuB;AACvB,QAAM,MAAM,SAAS,OAAO,QAAQ,IAAI;AAGxC,QAAM,aAAa,SAAS;AAE5B,QAAM,SAAS,UAAM,uBAAyB;AAAA,IAC5C,MAAM;AAAA,IACN;AAAA,IACA,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,IACjD,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,aAAa;AAAA,IACb,QAAQ;AAAA,EACV,CAAC;AAED,QAAM,SAAS,OAAO,UAAU,CAAC;AACjC,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,IAAI,0BAA0B,GAAG;AAAA,EACzC;AAEA,SAAO,OAAO,UAAU,CAAC;AAC3B;;;AC1DO,IAAM,wBAAN,cAAoC,MAAM;AAAA,EAC7B,OAAO;AAAA,EAChB;AAAA,EAET,YAAY,OAAe,SAAiB;AAC1C,UAAM,kBAAkB,KAAK,KAAK,OAAO,EAAE;AAC3C,SAAK,QAAQ;AAAA,EACf;AACF;AAEA,SAAS,iBAAiB,OAAiC;AACzD,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS;AACrD;AAEA,SAAS,oBACP,OACA,WACA,aACM;AACN,QAAM,gBAAgB,GAAG,WAAW,IAAI,SAAS;AACjD,MAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,UAAM,IAAI,sBAAsB,eAAe,kBAAkB;AAAA,EACnE;AACA,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,sBAAsB,eAAe,mBAAmB;AAAA,EACpE;AACA,aAAW,QAAQ,OAAO;AACxB,QAAI,CAAC,iBAAiB,IAAI,GAAG;AAC3B,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,oBACd,QAC0B;AAC1B,MAAI,OAAO,WAAW,QAAW;AAC/B,UAAM,IAAI,sBAAsB,UAAU,qBAAqB;AAAA,EACjE;AACA,sBAAoB,OAAO,OAAO,cAAc,gBAAgB,QAAQ;AACxE,SAAO,OAAO;AAChB;AAOO,SAAS,mBACd,QACyB;AACzB,MAAI,OAAO,UAAU,QAAW;AAC9B,UAAM,IAAI,sBAAsB,SAAS,qBAAqB;AAAA,EAChE;AACA,sBAAoB,OAAO,MAAM,aAAa,eAAe,OAAO;AAEpE,MAAI,OAAO,MAAM,cAAc,QAAW;AACxC,UAAM,EAAE,MAAM,OAAO,IAAI,OAAO,MAAM;AACtC,QAAI,CAAC,OAAO,UAAU,IAAI,KAAK,QAAQ,GAAG;AACxC,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,QAAI,WAAW,QAAW;AACxB,0BAAoB,QAAQ,oBAAoB,OAAO;AAAA,IACzD;AAAA,EACF;AAEA,SAAO,OAAO;AAChB;","names":[]}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export { defineBetterConfig } from "./define-config.js";
+export { loadBetterConfig, BetterConfigNotFoundError, } from "./config-loader.js";
+export type { LoadBetterConfigOptions } from "./config-loader.js";
+export { requireTenantConfig, requireAuditConfig, ConfigValidationError, } from "./config-validation.js";
+export type { BetterConfig, BetterTenantStaticConfig, BetterAuditStaticConfig, BetterConsoleStaticConfig, TelemetryConfig, PathResolverConfig, SubdomainResolverConfig, StaticJwtResolverConfig, StaticTenantResolverConfig, RetentionPolicy, StaticMagicLinkConfig, StaticConsoleSessionConfig, } from "./config-types.js";
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAIhC,YAAY,EACV,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,eAAe,EACf,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC"}

package/dist/config.js

@@ -0,0 +1,110 @@
+// src/define-config.ts
+function defineBetterConfig(config) {
+  return config;
+}
+
+// src/config-loader.ts
+import { loadConfig } from "c12";
+var BetterConfigNotFoundError = class extends Error {
+  name = "BetterConfigNotFoundError";
+  cwd;
+  constructor(cwd) {
+    super(
+      [
+        `No better.config.{ts,js,mjs} file found in ${cwd}.`,
+        "",
+        "Create one with:",
+        "",
+        '  import { defineBetterConfig } from "@usebetterdev/plugin/config";',
+        "",
+        "  export default defineBetterConfig({",
+        '    tenant: { tenantTables: ["organizations"] },',
+        "  });"
+      ].join("\n")
+    );
+    this.cwd = cwd;
+  }
+};
+async function loadBetterConfig(options) {
+  const cwd = options?.cwd ?? process.cwd();
+  const configFile = options?.configPath;
+  const result = await loadConfig({
+    name: "better",
+    cwd,
+    ...configFile !== void 0 ? { configFile } : {},
+    rcFile: false,
+    globalRc: false,
+    packageJson: false,
+    dotenv: false
+  });
+  const layers = result.layers ?? [];
+  if (layers.length === 0) {
+    throw new BetterConfigNotFoundError(cwd);
+  }
+  return result.config ?? {};
+}
+
+// src/config-validation.ts
+var ConfigValidationError = class extends Error {
+  name = "ConfigValidationError";
+  field;
+  constructor(field, message) {
+    super(`Config error: "${field}" ${message}`);
+    this.field = field;
+  }
+};
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function validateStringArray(items, fieldName, sectionName) {
+  const qualifiedName = `${sectionName}.${fieldName}`;
+  if (!Array.isArray(items)) {
+    throw new ConfigValidationError(qualifiedName, "must be an array");
+  }
+  if (items.length === 0) {
+    throw new ConfigValidationError(qualifiedName, "must not be empty");
+  }
+  for (const item of items) {
+    if (!isNonEmptyString(item)) {
+      throw new ConfigValidationError(
+        qualifiedName,
+        "entries must be non-empty strings"
+      );
+    }
+  }
+}
+function requireTenantConfig(config) {
+  if (config.tenant === void 0) {
+    throw new ConfigValidationError("tenant", "section is required");
+  }
+  validateStringArray(config.tenant.tenantTables, "tenantTables", "tenant");
+  return config.tenant;
+}
+function requireAuditConfig(config) {
+  if (config.audit === void 0) {
+    throw new ConfigValidationError("audit", "section is required");
+  }
+  validateStringArray(config.audit.auditTables, "auditTables", "audit");
+  if (config.audit.retention !== void 0) {
+    const { days, tables } = config.audit.retention;
+    if (!Number.isInteger(days) || days <= 0) {
+      throw new ConfigValidationError(
+        "audit.retention.days",
+        "must be a positive integer"
+      );
+    }
+    if (tables !== void 0) {
+      validateStringArray(tables, "retention.tables", "audit");
+    }
+  }
+  return config.audit;
+}
+export {
+  BetterConfigNotFoundError,
+  ConfigValidationError,
+  defineBetterConfig,
+  loadBetterConfig,
+  requireAuditConfig,
+  requireTenantConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/define-config.ts","../src/config-loader.ts","../src/config-validation.ts"],"sourcesContent":["import type { BetterConfig } from \"./config-types.js\";\n\n/**\n * Identity helper that provides TypeScript autocomplete for `better.config.ts`.\n *\n * ```ts\n * // better.config.ts\n * import { defineBetterConfig } from \"@usebetterdev/plugin/config\";\n *\n * export default defineBetterConfig({\n *   tenant: { tenantTables: [\"organizations\"] },\n * });\n * ```\n */\nexport function defineBetterConfig(config: BetterConfig): BetterConfig {\n  return config;\n}\n","import { loadConfig } from \"c12\";\nimport type { BetterConfig } from \"./config-types.js\";\n\n/** Thrown when no `better.config.*` file is found in the working directory. */\nexport class BetterConfigNotFoundError extends Error {\n  override readonly name = \"BetterConfigNotFoundError\";\n  readonly cwd: string;\n\n  constructor(cwd: string) {\n    super(\n      [\n        `No better.config.{ts,js,mjs} file found in ${cwd}.`,\n        \"\",\n        \"Create one with:\",\n        \"\",\n        '  import { defineBetterConfig } from \"@usebetterdev/plugin/config\";',\n        \"\",\n        \"  export default defineBetterConfig({\",\n        '    tenant: { tenantTables: [\"organizations\"] },',\n        \"  });\",\n      ].join(\"\\n\"),\n    );\n    this.cwd = cwd;\n  }\n}\n\nexport interface LoadBetterConfigOptions {\n  /** Working directory to search for the config file. Defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Explicit path to a config file, bypassing discovery. Maps to c12's `configFile` option. */\n  configPath?: string;\n}\n\n/**\n * Loads a `better.config.{ts,js,mjs}` file using c12.\n * Throws {@link BetterConfigNotFoundError} when no config file is found.\n *\n * The returned config is **unvalidated**. Pass it through\n * {@link requireTenantConfig} or {@link requireAuditConfig} to validate\n * product-specific sections.\n */\nexport async function loadBetterConfig(\n  options?: LoadBetterConfigOptions,\n): Promise<BetterConfig> {\n  const cwd = options?.cwd ?? process.cwd();\n\n  // configPath maps to c12's configFile — spread conditionally to satisfy exactOptionalPropertyTypes\n  const configFile = options?.configPath;\n\n  const result = await loadConfig<BetterConfig>({\n    name: \"better\",\n    cwd,\n    ...(configFile !== undefined ? { configFile } : {}),\n    rcFile: false,\n    globalRc: false,\n    packageJson: false,\n    dotenv: false,\n  });\n\n  const layers = result.layers ?? [];\n  if (layers.length === 0) {\n    throw new BetterConfigNotFoundError(cwd);\n  }\n\n  return result.config ?? {};\n}\n","import type {\n  BetterConfig,\n  BetterTenantStaticConfig,\n  BetterAuditStaticConfig,\n} from \"./config-types.js\";\n\n/** Thrown when a config section fails validation. */\nexport class ConfigValidationError extends Error {\n  override readonly name = \"ConfigValidationError\";\n  readonly field: string;\n\n  constructor(field: string, message: string) {\n    super(`Config error: \"${field}\" ${message}`);\n    this.field = field;\n  }\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\nfunction validateStringArray(\n  items: unknown,\n  fieldName: string,\n  sectionName: string,\n): void {\n  const qualifiedName = `${sectionName}.${fieldName}`;\n  if (!Array.isArray(items)) {\n    throw new ConfigValidationError(qualifiedName, \"must be an array\");\n  }\n  if (items.length === 0) {\n    throw new ConfigValidationError(qualifiedName, \"must not be empty\");\n  }\n  for (const item of items) {\n    if (!isNonEmptyString(item)) {\n      throw new ConfigValidationError(\n        qualifiedName,\n        \"entries must be non-empty strings\",\n      );\n    }\n  }\n}\n\n/**\n * Validates that `config.tenant` exists and its `tenantTables` is a non-empty\n * array of non-empty strings. Returns the narrowed tenant config.\n */\nexport function requireTenantConfig(\n  config: BetterConfig,\n): BetterTenantStaticConfig {\n  if (config.tenant === undefined) {\n    throw new ConfigValidationError(\"tenant\", \"section is required\");\n  }\n  validateStringArray(config.tenant.tenantTables, \"tenantTables\", \"tenant\");\n  return config.tenant;\n}\n\n/**\n * Validates that `config.audit` exists and its `auditTables` is a non-empty\n * array of non-empty strings. When `retention` is present, validates `days` is\n * a positive integer and `tables` (if present) is a non-empty string array.\n */\nexport function requireAuditConfig(\n  config: BetterConfig,\n): BetterAuditStaticConfig {\n  if (config.audit === undefined) {\n    throw new ConfigValidationError(\"audit\", \"section is required\");\n  }\n  validateStringArray(config.audit.auditTables, \"auditTables\", \"audit\");\n\n  if (config.audit.retention !== undefined) {\n    const { days, tables } = config.audit.retention;\n    if (!Number.isInteger(days) || days <= 0) {\n      throw new ConfigValidationError(\n        \"audit.retention.days\",\n        \"must be a positive integer\",\n      );\n    }\n    if (tables !== undefined) {\n      validateStringArray(tables, \"retention.tables\", \"audit\");\n    }\n  }\n\n  return config.audit;\n}\n"],"mappings":";AAcO,SAAS,mBAAmB,QAAoC;AACrE,SAAO;AACT;;;AChBA,SAAS,kBAAkB;AAIpB,IAAM,4BAAN,cAAwC,MAAM;AAAA,EACjC,OAAO;AAAA,EAChB;AAAA,EAET,YAAY,KAAa;AACvB;AAAA,MACE;AAAA,QACE,8CAA8C,GAAG;AAAA,QACjD;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,IAAI;AAAA,IACb;AACA,SAAK,MAAM;AAAA,EACb;AACF;AAiBA,eAAsB,iBACpB,SACuB;AACvB,QAAM,MAAM,SAAS,OAAO,QAAQ,IAAI;AAGxC,QAAM,aAAa,SAAS;AAE5B,QAAM,SAAS,MAAM,WAAyB;AAAA,IAC5C,MAAM;AAAA,IACN;AAAA,IACA,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,IACjD,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,aAAa;AAAA,IACb,QAAQ;AAAA,EACV,CAAC;AAED,QAAM,SAAS,OAAO,UAAU,CAAC;AACjC,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,IAAI,0BAA0B,GAAG;AAAA,EACzC;AAEA,SAAO,OAAO,UAAU,CAAC;AAC3B;;;AC1DO,IAAM,wBAAN,cAAoC,MAAM;AAAA,EAC7B,OAAO;AAAA,EAChB;AAAA,EAET,YAAY,OAAe,SAAiB;AAC1C,UAAM,kBAAkB,KAAK,KAAK,OAAO,EAAE;AAC3C,SAAK,QAAQ;AAAA,EACf;AACF;AAEA,SAAS,iBAAiB,OAAiC;AACzD,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS;AACrD;AAEA,SAAS,oBACP,OACA,WACA,aACM;AACN,QAAM,gBAAgB,GAAG,WAAW,IAAI,SAAS;AACjD,MAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,UAAM,IAAI,sBAAsB,eAAe,kBAAkB;AAAA,EACnE;AACA,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,sBAAsB,eAAe,mBAAmB;AAAA,EACpE;AACA,aAAW,QAAQ,OAAO;AACxB,QAAI,CAAC,iBAAiB,IAAI,GAAG;AAC3B,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,oBACd,QAC0B;AAC1B,MAAI,OAAO,WAAW,QAAW;AAC/B,UAAM,IAAI,sBAAsB,UAAU,qBAAqB;AAAA,EACjE;AACA,sBAAoB,OAAO,OAAO,cAAc,gBAAgB,QAAQ;AACxE,SAAO,OAAO;AAChB;AAOO,SAAS,mBACd,QACyB;AACzB,MAAI,OAAO,UAAU,QAAW;AAC9B,UAAM,IAAI,sBAAsB,SAAS,qBAAqB;AAAA,EAChE;AACA,sBAAoB,OAAO,MAAM,aAAa,eAAe,OAAO;AAEpE,MAAI,OAAO,MAAM,cAAc,QAAW;AACxC,UAAM,EAAE,MAAM,OAAO,IAAI,OAAO,MAAM;AACtC,QAAI,CAAC,OAAO,UAAU,IAAI,KAAK,QAAQ,GAAG;AACxC,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,QAAI,WAAW,QAAW;AACxB,0BAAoB,QAAQ,oBAAoB,OAAO;AAAA,IACzD;AAAA,EACF;AAEA,SAAO,OAAO;AAChB;","names":[]}

package/dist/define-config.d.ts

@@ -0,0 +1,15 @@
+import type { BetterConfig } from "./config-types.js";
+/**
+ * Identity helper that provides TypeScript autocomplete for `better.config.ts`.
+ *
+ * ```ts
+ * // better.config.ts
+ * import { defineBetterConfig } from "@usebetterdev/plugin/config";
+ *
+ * export default defineBetterConfig({
+ *   tenant: { tenantTables: ["organizations"] },
+ * });
+ * ```
+ */
+export declare function defineBetterConfig(config: BetterConfig): BetterConfig;
+//# sourceMappingURL=define-config.d.ts.map

package/dist/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../src/define-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAErE"}

package/dist/demo/auth-events.d.ts

@@ -0,0 +1,34 @@
+export declare const authEvents: () => {
+    id: string;
+    schema: {
+        tables: {
+            auth_events: {
+                fields: {
+                    id: {
+                        type: "string";
+                        required: true;
+                        unique: true;
+                    };
+                    event_type: {
+                        type: "string";
+                        required: true;
+                    };
+                    user_id: {
+                        type: "string";
+                        required: true;
+                        index: true;
+                    };
+                    timestamp: {
+                        type: "date";
+                        required: true;
+                        defaultValue: () => Date;
+                    };
+                    metadata: {
+                        type: "json";
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=auth-events.d.ts.map

package/dist/demo/auth-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-events.d.ts","sourceRoot":"","sources":["../../src/demo/auth-events.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBtB,CAAC"}

package/dist/demo/webhook-dispatcher.d.ts

@@ -0,0 +1,74 @@
+export type AuditHookContract = {
+    afterLog: {
+        log: Readonly<{
+            id: string;
+            tableName: string;
+        }>;
+    };
+};
+export interface WebhookDispatcherConfig {
+    /** Target URL to POST event payloads to. */
+    url: string;
+    /** Optional list of event types to forward. When omitted, all events are forwarded. */
+    events?: string[];
+}
+export declare const webhookDispatcher: (config: WebhookDispatcherConfig) => {
+    id: string;
+    hooks: {
+        afterLog: (_payload: {
+            log: Readonly<{
+                id: string;
+                tableName: string;
+            }>;
+        }) => Promise<void>;
+    };
+    schema: {
+        tables: {
+            webhook_deliveries: {
+                fields: {
+                    id: {
+                        type: "string";
+                        required: true;
+                        unique: true;
+                    };
+                    endpoint_url: {
+                        type: "string";
+                        required: true;
+                        index: true;
+                    };
+                    event_type: {
+                        type: "string";
+                        required: true;
+                    };
+                    status: {
+                        type: "string";
+                        required: true;
+                    };
+                    http_status: {
+                        type: "number";
+                    };
+                    attempt_count: {
+                        type: "number";
+                        required: true;
+                        defaultValue: number;
+                    };
+                    last_attempt_at: {
+                        type: "date";
+                    };
+                    created_at: {
+                        type: "date";
+                        required: true;
+                    };
+                };
+            };
+        };
+        extend: {
+            audit_log: {
+                webhook_delivered_at: {
+                    type: "date";
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=webhook-dispatcher.d.ts.map

package/dist/demo/webhook-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-dispatcher.d.ts","sourceRoot":"","sources":["../../src/demo/webhook-dispatcher.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE;QAAE,GAAG,EAAE,QAAQ,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAChE,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB,WAAY,uBAAuB;;;;iBAV9C,QAAQ,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6C7D,CAAC"}

package/dist/index.cjs

@@ -152,8 +152,51 @@ function assertOneOf(value, allowed, name) {
 }
 
 // src/schema.ts
-function mergeSchemas(_plugins) {
-  return { tables: {}, extend: {} };
+function mergeSchemas(plugins) {
+  const tables = {};
+  const extend = {};
+  const tableOwners = /* @__PURE__ */ new Map();
+  const fieldOwners = /* @__PURE__ */ new Map();
+  for (const plugin of plugins) {
+    if (!plugin.schema) {
+      continue;
+    }
+    if (plugin.schema.tables) {
+      for (const [tableName, tableDef] of Object.entries(
+        plugin.schema.tables
+      )) {
+        const existingOwner = tableOwners.get(tableName);
+        if (existingOwner !== void 0) {
+          throw new Error(
+            `Schema conflict: table "${tableName}" defined by both "${existingOwner}" and "${plugin.id}"`
+          );
+        }
+        tableOwners.set(tableName, plugin.id);
+        tables[tableName] = tableDef;
+      }
+    }
+    if (plugin.schema.extend) {
+      for (const [tableName, fields] of Object.entries(plugin.schema.extend)) {
+        let tableExtensions = extend[tableName];
+        if (tableExtensions === void 0) {
+          tableExtensions = {};
+          extend[tableName] = tableExtensions;
+        }
+        for (const [fieldName, fieldDef] of Object.entries(fields)) {
+          const key = `${tableName}.${fieldName}`;
+          const existingOwner = fieldOwners.get(key);
+          if (existingOwner !== void 0) {
+            throw new Error(
+              `Schema conflict: field "${tableName}.${fieldName}" extended by both "${existingOwner}" and "${plugin.id}"`
+            );
+          }
+          fieldOwners.set(key, plugin.id);
+          tableExtensions[fieldName] = fieldDef;
+        }
+      }
+    }
+  }
+  return { tables, extend };
 }
 
 // src/resolve-plugins.ts

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/hook-registry.ts","../src/validation.ts","../src/schema.ts","../src/resolve-plugins.ts"],"sourcesContent":["export type {\n  HookContract,\n  HookHandlers,\n  PluginContext,\n  FieldType,\n  PluginFieldDefinition,\n  PluginTableDefinition,\n  PluginSchema,\n  HttpMethod,\n  PluginRequestContext,\n  PluginResponse,\n  PluginEndpointHandler,\n  PluginEndpoint,\n  PluginDefinition,\n} from \"./types.js\";\n\nexport { HookRegistry, PluginInvokeError } from \"./hook-registry.js\";\nexport type { PluginError } from \"./hook-registry.js\";\n\nexport { assertDefined, assertOneOf } from \"./validation.js\";\n\nexport { mergeSchemas } from \"./schema.js\";\nexport type { MergedPluginSchema } from \"./schema.js\";\n\nexport { resolvePlugins, PluginInitError } from \"./resolve-plugins.js\";\nexport type { ResolvedPlugins, ResolvedEndpoint } from \"./resolve-plugins.js\";\n","import type { HookContract, HookHandlers } from \"./types.js\";\n\n/**\n * Error captured when a plugin hook handler fails during `invokeAfter`.\n */\nexport interface PluginError {\n  pluginId: string;\n  hook: string;\n  error: unknown;\n}\n\n/**\n * Error thrown by `invokeBefore` when a plugin hook handler fails.\n * Wraps the original error with plugin and hook context so callers\n * can identify which plugin caused the failure.\n */\nexport class PluginInvokeError extends Error {\n  override readonly name = \"PluginInvokeError\";\n  readonly pluginId: string;\n  readonly hook: string;\n\n  constructor(pluginId: string, hook: string, cause: unknown) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    super(`Plugin \"${pluginId}\" failed on hook \"${hook}\": ${detail}`, {\n      cause,\n    });\n    this.pluginId = pluginId;\n    this.hook = hook;\n  }\n}\n\n/**\n * Internal handler entry. The handler is typed as `(payload: never) => …`\n * because any function `(payload: T) => R` is assignable to it (contravariance\n * on `never`). This avoids a type assertion at registration time.\n */\ninterface RegisteredHook {\n  pluginId: string;\n  handler: (payload: never) => void | Promise<void>;\n}\n\n/**\n * Runtime registry that products use to register plugin hooks and invoke them\n * at lifecycle points.\n *\n * Generic over THooks so products get type-safe hook names and payloads.\n */\nexport class HookRegistry<THooks extends HookContract> {\n  private hooks = new Map<string, RegisteredHook[]>();\n  private registeredPlugins = new Set<string>();\n\n  /**\n   * Register all hooks declared by a plugin. Skips entries whose value is not\n   * a function (defensive against partial/optional declarations).\n   *\n   * Throws if a plugin with the same ID has already been registered.\n   */\n  register(pluginId: string, hooks: Partial<HookHandlers<THooks>>): void {\n    if (this.registeredPlugins.has(pluginId)) {\n      throw new Error(`Plugin \"${pluginId}\" is already registered`);\n    }\n    this.registeredPlugins.add(pluginId);\n\n    for (const [key, handler] of Object.entries(hooks)) {\n      if (typeof handler !== \"function\") {\n        continue;\n      }\n\n      let list = this.hooks.get(key);\n      if (list === undefined) {\n        list = [];\n        this.hooks.set(key, list);\n      }\n      list.push({ pluginId, handler });\n    }\n  }\n\n  /**\n   * Sequential, fail-fast invocation — for \"before\" hooks.\n   * Runs handlers in registration order. Aborts on first throw and wraps\n   * the error in a {@link PluginInvokeError} so the caller knows which\n   * plugin failed. Later handlers are **not** called.\n   *\n   * Uses a snapshot of the handler list so that registrations during\n   * async execution do not affect the current invocation.\n   */\n  async invokeBefore<K extends keyof THooks & string>(\n    hook: K,\n    payload: THooks[K],\n  ): Promise<void> {\n    const list = this.hooks.get(hook);\n    if (list === undefined) {\n      return;\n    }\n    const snapshot = [...list];\n    for (const entry of snapshot) {\n      try {\n        await this.callHandler(entry.handler, payload);\n      } catch (error: unknown) {\n        throw new PluginInvokeError(entry.pluginId, hook, error);\n      }\n    }\n  }\n\n  /**\n   * Sequential, collect-errors invocation — for \"after\" hooks.\n   * Runs **all** handlers even when some fail. Failures are wrapped in\n   * {@link PluginError} and returned as an array. Returns an empty array\n   * when all handlers succeed or when no handlers are registered.\n   *\n   * Uses a snapshot of the handler list so that registrations during\n   * async execution do not affect the current invocation.\n   */\n  async invokeAfter<K extends keyof THooks & string>(\n    hook: K,\n    payload: THooks[K],\n  ): Promise<PluginError[]> {\n    const list = this.hooks.get(hook);\n    if (list === undefined) {\n      return [];\n    }\n\n    const errors: PluginError[] = [];\n    const snapshot = [...list];\n    for (const entry of snapshot) {\n      try {\n        await this.callHandler(entry.handler, payload);\n      } catch (error: unknown) {\n        errors.push({\n          pluginId: entry.pluginId,\n          hook,\n          error,\n        });\n      }\n    }\n    return errors;\n  }\n\n  /**\n   * Calls a stored handler with the given payload.\n   *\n   * Handlers are stored as `(payload: never) => …` for variance compatibility\n   * (see {@link RegisteredHook}). At runtime the payload always matches\n   * `THooks[K]` — guaranteed by the generic constraint on {@link register}.\n   * This single assertion is the only place where TypeScript's type system\n   * cannot statically verify the heterogeneous map access.\n   */\n  private callHandler<K extends keyof THooks>(\n    handler: (payload: never) => void | Promise<void>,\n    payload: THooks[K],\n  ): void | Promise<void> {\n    return (handler as (p: THooks[K]) => void | Promise<void>)(payload);\n  }\n}\n","/**\n * Asserts that a value is not `undefined`.\n * Throws with a descriptive error message following the plugin config error pattern.\n */\nexport function assertDefined<T>(\n  value: T | undefined,\n  name: string,\n): asserts value is T {\n  if (value === undefined) {\n    throw new Error(`Plugin config error: \"${name}\" is required`);\n  }\n}\n\n/**\n * Asserts that a value is one of the allowed values.\n * Throws with a descriptive error message listing the allowed options.\n */\nexport function assertOneOf<T extends string | number | boolean>(value: T, allowed: T[], name: string): void {\n  if (!allowed.includes(value)) {\n    const allowedStr = allowed.join(\", \");\n    throw new Error(\n      `Plugin config error: \"${name}\" must be one of: ${allowedStr} (got: ${String(value)})`,\n    );\n  }\n}\n","import type {\n  HookContract,\n  PluginDefinition,\n  PluginFieldDefinition,\n  PluginTableDefinition,\n} from \"./types.js\";\n\n/**\n * Merged schema produced by combining all plugin schema declarations.\n * Unlike per-plugin `PluginSchema` (where fields are optional),\n * the merged result always contains both maps.\n */\nexport interface MergedPluginSchema {\n  tables: Record<string, PluginTableDefinition>;\n  extend: Record<string, Record<string, PluginFieldDefinition>>;\n}\n\n/**\n * Merges schema declarations from all plugins into a single result.\n *\n * Returns empty maps. Full merge logic (conflict detection, ordering)\n * will be added when schema merging is needed.\n */\nexport function mergeSchemas<THooks extends HookContract>(\n  _plugins: PluginDefinition<THooks>[],\n): MergedPluginSchema {\n  return { tables: {}, extend: {} };\n}\n","import { HookRegistry } from \"./hook-registry.js\";\nimport type { MergedPluginSchema } from \"./schema.js\";\nimport { mergeSchemas } from \"./schema.js\";\nimport type {\n  HookContract,\n  PluginContext,\n  PluginDefinition,\n  PluginEndpoint,\n} from \"./types.js\";\n\nexport class PluginInitError extends Error {\n  override readonly name = \"PluginInitError\";\n  readonly pluginId: string;\n\n  constructor(pluginId: string, cause: unknown) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    super(`Plugin \"${pluginId}\" failed during init: ${detail}`, { cause });\n    this.pluginId = pluginId;\n  }\n}\n\n/**\n * A collected endpoint annotated with the plugin that contributed it.\n */\nexport interface ResolvedEndpoint extends PluginEndpoint {\n  pluginId: string;\n}\n\n/**\n * Result of resolving a set of plugins. Contains the fully wired\n * hook registry, collected endpoints, merged schema, and plugin IDs.\n */\nexport interface ResolvedPlugins<THooks extends HookContract> {\n  hookRegistry: HookRegistry<THooks>;\n  endpoints: ResolvedEndpoint[];\n  schema: MergedPluginSchema;\n  pluginIds: string[];\n}\n\n/**\n * Lifecycle orchestrator that products call during construction.\n *\n * Steps:\n * 1. **Validate** — duplicate IDs throw immediately\n * 2. **Register hooks** — into a new HookRegistry\n * 3. **Collect endpoints** — flat array from all plugins\n * 4. **Merge schemas** — calls mergeSchemas\n * 5. **Init** — call plugin.init(ctx) sequentially in declaration order\n */\nexport async function resolvePlugins<THooks extends HookContract>(\n  productId: string,\n  plugins: PluginDefinition<THooks>[],\n  config: Record<string, unknown>,\n): Promise<ResolvedPlugins<THooks>> {\n  // 1. Validate — check for empty/whitespace IDs and duplicates\n  const seen = new Set<string>();\n  for (const plugin of plugins) {\n    if (!plugin.id || !plugin.id.trim()) {\n      throw new Error('Plugin config error: \"id\" is required');\n    }\n    if (plugin.id !== plugin.id.trim()) {\n      throw new Error(\n        `Plugin config error: \"id\" must not have leading or trailing whitespace (got: \"${plugin.id}\")`,\n      );\n    }\n    if (seen.has(plugin.id)) {\n      throw new Error(`Duplicate plugin ID: \"${plugin.id}\"`);\n    }\n    seen.add(plugin.id);\n  }\n\n  // 2. Register hooks\n  const hookRegistry = new HookRegistry<THooks>();\n  for (const plugin of plugins) {\n    if (plugin.hooks) {\n      hookRegistry.register(plugin.id, plugin.hooks);\n    }\n  }\n\n  // 3. Collect endpoints (annotated with pluginId)\n  const endpoints: ResolvedEndpoint[] = [];\n  for (const plugin of plugins) {\n    if (plugin.endpoints) {\n      for (const ep of plugin.endpoints) {\n        if (!ep.path || !ep.path.startsWith(\"/\")) {\n          throw new Error(\n            `Plugin \"${plugin.id}\" endpoint path must start with \"/\" (got: \"${ep.path}\")`,\n          );\n        }\n        endpoints.push({ ...ep, pluginId: plugin.id });\n      }\n    }\n  }\n\n  // 4. Merge schemas\n  const schema = mergeSchemas(plugins);\n\n  // 5. Init — sequential in declaration order\n  const pluginIds = plugins.map((p) => p.id);\n  const frozenConfig = Object.freeze({ ...config });\n  const context: PluginContext = {\n    productId,\n    hasPlugin: (id: string) => seen.has(id),\n    config: frozenConfig,\n  };\n\n  for (const plugin of plugins) {\n    if (plugin.init) {\n      try {\n        await plugin.init(context);\n      } catch (err) {\n        throw new PluginInitError(plugin.id, err);\n      }\n    }\n  }\n\n  return { hookRegistry, endpoints, schema, pluginIds };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/hook-registry.ts","../src/validation.ts","../src/schema.ts","../src/resolve-plugins.ts"],"sourcesContent":["export type {\n  HookContract,\n  HookHandlers,\n  PluginContext,\n  FieldType,\n  PluginFieldDefinition,\n  PluginTableDefinition,\n  PluginSchema,\n  HttpMethod,\n  PluginRequestContext,\n  PluginResponse,\n  PluginEndpointHandler,\n  PluginEndpoint,\n  PluginDefinition,\n} from \"./types.js\";\n\nexport { HookRegistry, PluginInvokeError } from \"./hook-registry.js\";\nexport type { PluginError } from \"./hook-registry.js\";\n\nexport { assertDefined, assertOneOf } from \"./validation.js\";\n\nexport { mergeSchemas } from \"./schema.js\";\nexport type { MergedPluginSchema } from \"./schema.js\";\n\nexport { resolvePlugins, PluginInitError } from \"./resolve-plugins.js\";\nexport type { ResolvedPlugins, ResolvedEndpoint } from \"./resolve-plugins.js\";\n\nexport type {\n  BetterConfig,\n  BetterTenantStaticConfig,\n  BetterAuditStaticConfig,\n  BetterConsoleStaticConfig,\n} from \"./config-types.js\";\n","import type { HookContract, HookHandlers } from \"./types.js\";\n\n/**\n * Error captured when a plugin hook handler fails during `invokeAfter`.\n */\nexport interface PluginError {\n  pluginId: string;\n  hook: string;\n  error: unknown;\n}\n\n/**\n * Error thrown by `invokeBefore` when a plugin hook handler fails.\n * Wraps the original error with plugin and hook context so callers\n * can identify which plugin caused the failure.\n */\nexport class PluginInvokeError extends Error {\n  override readonly name = \"PluginInvokeError\";\n  readonly pluginId: string;\n  readonly hook: string;\n\n  constructor(pluginId: string, hook: string, cause: unknown) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    super(`Plugin \"${pluginId}\" failed on hook \"${hook}\": ${detail}`, {\n      cause,\n    });\n    this.pluginId = pluginId;\n    this.hook = hook;\n  }\n}\n\n/**\n * Internal handler entry. The handler is typed as `(payload: never) => …`\n * because any function `(payload: T) => R` is assignable to it (contravariance\n * on `never`). This avoids a type assertion at registration time.\n */\ninterface RegisteredHook {\n  pluginId: string;\n  handler: (payload: never) => void | Promise<void>;\n}\n\n/**\n * Runtime registry that products use to register plugin hooks and invoke them\n * at lifecycle points.\n *\n * Generic over THooks so products get type-safe hook names and payloads.\n */\nexport class HookRegistry<THooks extends HookContract> {\n  private hooks = new Map<string, RegisteredHook[]>();\n  private registeredPlugins = new Set<string>();\n\n  /**\n   * Register all hooks declared by a plugin. Skips entries whose value is not\n   * a function (defensive against partial/optional declarations).\n   *\n   * Throws if a plugin with the same ID has already been registered.\n   */\n  register(pluginId: string, hooks: Partial<HookHandlers<THooks>>): void {\n    if (this.registeredPlugins.has(pluginId)) {\n      throw new Error(`Plugin \"${pluginId}\" is already registered`);\n    }\n    this.registeredPlugins.add(pluginId);\n\n    for (const [key, handler] of Object.entries(hooks)) {\n      if (typeof handler !== \"function\") {\n        continue;\n      }\n\n      let list = this.hooks.get(key);\n      if (list === undefined) {\n        list = [];\n        this.hooks.set(key, list);\n      }\n      list.push({ pluginId, handler });\n    }\n  }\n\n  /**\n   * Sequential, fail-fast invocation — for \"before\" hooks.\n   * Runs handlers in registration order. Aborts on first throw and wraps\n   * the error in a {@link PluginInvokeError} so the caller knows which\n   * plugin failed. Later handlers are **not** called.\n   *\n   * Uses a snapshot of the handler list so that registrations during\n   * async execution do not affect the current invocation.\n   */\n  async invokeBefore<K extends keyof THooks & string>(\n    hook: K,\n    payload: THooks[K],\n  ): Promise<void> {\n    const list = this.hooks.get(hook);\n    if (list === undefined) {\n      return;\n    }\n    const snapshot = [...list];\n    for (const entry of snapshot) {\n      try {\n        await this.callHandler(entry.handler, payload);\n      } catch (error: unknown) {\n        throw new PluginInvokeError(entry.pluginId, hook, error);\n      }\n    }\n  }\n\n  /**\n   * Sequential, collect-errors invocation — for \"after\" hooks.\n   * Runs **all** handlers even when some fail. Failures are wrapped in\n   * {@link PluginError} and returned as an array. Returns an empty array\n   * when all handlers succeed or when no handlers are registered.\n   *\n   * Uses a snapshot of the handler list so that registrations during\n   * async execution do not affect the current invocation.\n   */\n  async invokeAfter<K extends keyof THooks & string>(\n    hook: K,\n    payload: THooks[K],\n  ): Promise<PluginError[]> {\n    const list = this.hooks.get(hook);\n    if (list === undefined) {\n      return [];\n    }\n\n    const errors: PluginError[] = [];\n    const snapshot = [...list];\n    for (const entry of snapshot) {\n      try {\n        await this.callHandler(entry.handler, payload);\n      } catch (error: unknown) {\n        errors.push({\n          pluginId: entry.pluginId,\n          hook,\n          error,\n        });\n      }\n    }\n    return errors;\n  }\n\n  /**\n   * Calls a stored handler with the given payload.\n   *\n   * Handlers are stored as `(payload: never) => …` for variance compatibility\n   * (see {@link RegisteredHook}). At runtime the payload always matches\n   * `THooks[K]` — guaranteed by the generic constraint on {@link register}.\n   * This single assertion is the only place where TypeScript's type system\n   * cannot statically verify the heterogeneous map access.\n   */\n  private callHandler<K extends keyof THooks>(\n    handler: (payload: never) => void | Promise<void>,\n    payload: THooks[K],\n  ): void | Promise<void> {\n    return (handler as (p: THooks[K]) => void | Promise<void>)(payload);\n  }\n}\n","/**\n * Asserts that a value is not `undefined`.\n * Throws with a descriptive error message following the plugin config error pattern.\n */\nexport function assertDefined<T>(\n  value: T | undefined,\n  name: string,\n): asserts value is T {\n  if (value === undefined) {\n    throw new Error(`Plugin config error: \"${name}\" is required`);\n  }\n}\n\n/**\n * Asserts that a value is one of the allowed values.\n * Throws with a descriptive error message listing the allowed options.\n */\nexport function assertOneOf<T extends string | number | boolean>(value: T, allowed: T[], name: string): void {\n  if (!allowed.includes(value)) {\n    const allowedStr = allowed.join(\", \");\n    throw new Error(\n      `Plugin config error: \"${name}\" must be one of: ${allowedStr} (got: ${String(value)})`,\n    );\n  }\n}\n","import type {\n  HookContract,\n  PluginDefinition,\n  PluginFieldDefinition,\n  PluginTableDefinition,\n} from \"./types.js\";\n\n/**\n * Merged schema produced by combining all plugin schema declarations.\n * Unlike per-plugin `PluginSchema` (where fields are optional),\n * the merged result always contains both maps.\n */\nexport interface MergedPluginSchema {\n  tables: Record<string, PluginTableDefinition>;\n  extend: Record<string, Record<string, PluginFieldDefinition>>;\n}\n\n/**\n * Merges schema declarations from all plugins into a single result.\n *\n * Iterates plugins in declaration order and collects new tables and\n * extended fields. Throws on conflicts:\n * - Two plugins defining the same table name\n * - Two plugins extending the same field on the same table\n */\nexport function mergeSchemas<THooks extends HookContract>(\n  plugins: PluginDefinition<THooks>[],\n): MergedPluginSchema {\n  const tables: Record<string, PluginTableDefinition> = {};\n  const extend: Record<string, Record<string, PluginFieldDefinition>> = {};\n\n  const tableOwners = new Map<string, string>();\n  const fieldOwners = new Map<string, string>();\n\n  for (const plugin of plugins) {\n    if (!plugin.schema) {\n      continue;\n    }\n\n    if (plugin.schema.tables) {\n      for (const [tableName, tableDef] of Object.entries(\n        plugin.schema.tables,\n      )) {\n        const existingOwner = tableOwners.get(tableName);\n        if (existingOwner !== undefined) {\n          throw new Error(\n            `Schema conflict: table \"${tableName}\" defined by both \"${existingOwner}\" and \"${plugin.id}\"`,\n          );\n        }\n        tableOwners.set(tableName, plugin.id);\n        tables[tableName] = tableDef;\n      }\n    }\n\n    if (plugin.schema.extend) {\n      for (const [tableName, fields] of Object.entries(plugin.schema.extend)) {\n        let tableExtensions = extend[tableName];\n        if (tableExtensions === undefined) {\n          tableExtensions = {};\n          extend[tableName] = tableExtensions;\n        }\n\n        for (const [fieldName, fieldDef] of Object.entries(fields)) {\n          const key = `${tableName}.${fieldName}`;\n          const existingOwner = fieldOwners.get(key);\n          if (existingOwner !== undefined) {\n            throw new Error(\n              `Schema conflict: field \"${tableName}.${fieldName}\" extended by both \"${existingOwner}\" and \"${plugin.id}\"`,\n            );\n          }\n          fieldOwners.set(key, plugin.id);\n          tableExtensions[fieldName] = fieldDef;\n        }\n      }\n    }\n  }\n\n  return { tables, extend };\n}\n","import { HookRegistry } from \"./hook-registry.js\";\nimport type { MergedPluginSchema } from \"./schema.js\";\nimport { mergeSchemas } from \"./schema.js\";\nimport type {\n  HookContract,\n  PluginContext,\n  PluginDefinition,\n  PluginEndpoint,\n} from \"./types.js\";\n\nexport class PluginInitError extends Error {\n  override readonly name = \"PluginInitError\";\n  readonly pluginId: string;\n\n  constructor(pluginId: string, cause: unknown) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    super(`Plugin \"${pluginId}\" failed during init: ${detail}`, { cause });\n    this.pluginId = pluginId;\n  }\n}\n\n/**\n * A collected endpoint annotated with the plugin that contributed it.\n */\nexport interface ResolvedEndpoint extends PluginEndpoint {\n  pluginId: string;\n}\n\n/**\n * Result of resolving a set of plugins. Contains the fully wired\n * hook registry, collected endpoints, merged schema, and plugin IDs.\n */\nexport interface ResolvedPlugins<THooks extends HookContract> {\n  hookRegistry: HookRegistry<THooks>;\n  endpoints: ResolvedEndpoint[];\n  schema: MergedPluginSchema;\n  pluginIds: string[];\n}\n\n/**\n * Lifecycle orchestrator that products call during construction.\n *\n * Steps:\n * 1. **Validate** — duplicate IDs throw immediately\n * 2. **Register hooks** — into a new HookRegistry\n * 3. **Collect endpoints** — flat array from all plugins\n * 4. **Merge schemas** — calls mergeSchemas\n * 5. **Init** — call plugin.init(ctx) sequentially in declaration order\n */\nexport async function resolvePlugins<THooks extends HookContract>(\n  productId: string,\n  plugins: PluginDefinition<THooks>[],\n  config: Record<string, unknown>,\n): Promise<ResolvedPlugins<THooks>> {\n  // 1. Validate — check for empty/whitespace IDs and duplicates\n  const seen = new Set<string>();\n  for (const plugin of plugins) {\n    if (!plugin.id || !plugin.id.trim()) {\n      throw new Error('Plugin config error: \"id\" is required');\n    }\n    if (plugin.id !== plugin.id.trim()) {\n      throw new Error(\n        `Plugin config error: \"id\" must not have leading or trailing whitespace (got: \"${plugin.id}\")`,\n      );\n    }\n    if (seen.has(plugin.id)) {\n      throw new Error(`Duplicate plugin ID: \"${plugin.id}\"`);\n    }\n    seen.add(plugin.id);\n  }\n\n  // 2. Register hooks\n  const hookRegistry = new HookRegistry<THooks>();\n  for (const plugin of plugins) {\n    if (plugin.hooks) {\n      hookRegistry.register(plugin.id, plugin.hooks);\n    }\n  }\n\n  // 3. Collect endpoints (annotated with pluginId)\n  const endpoints: ResolvedEndpoint[] = [];\n  for (const plugin of plugins) {\n    if (plugin.endpoints) {\n      for (const ep of plugin.endpoints) {\n        if (!ep.path || !ep.path.startsWith(\"/\")) {\n          throw new Error(\n            `Plugin \"${plugin.id}\" endpoint path must start with \"/\" (got: \"${ep.path}\")`,\n          );\n        }\n        endpoints.push({ ...ep, pluginId: plugin.id });\n      }\n    }\n  }\n\n  // 4. Merge schemas\n  const schema = mergeSchemas(plugins);\n\n  // 5. Init — sequential in declaration order\n  const pluginIds = plugins.map((p) => p.id);\n  const frozenConfig = Object.freeze({ ...config });\n  const context: PluginContext = {\n    productId,\n    hasPlugin: (id: string) => seen.has(id),\n    config: frozenConfig,\n  };\n\n  for (const plugin of plugins) {\n    if (plugin.init) {\n      try {\n        await plugin.init(context);\n      } catch (err) {\n        throw new PluginInitError(plugin.id, err);\n      }\n    }\n  }\n\n  return { hookRegistry, endpoints, schema, pluginIds };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -6,4 +6,5 @@ export { mergeSchemas } from "./schema.js";
 export type { MergedPluginSchema } from "./schema.js";
 export { resolvePlugins, PluginInitError } from "./resolve-plugins.js";
 export type { ResolvedPlugins, ResolvedEndpoint } from "./resolve-plugins.js";
+export type { BetterConfig, BetterTenantStaticConfig, BetterAuditStaticConfig, BetterConsoleStaticConfig, } from "./config-types.js";
 //# 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":"AAAA,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,YAAY,EACV,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -120,8 +120,51 @@ function assertOneOf(value, allowed, name) {
 }
 
 // src/schema.ts
-function mergeSchemas(_plugins) {
-  return { tables: {}, extend: {} };
+function mergeSchemas(plugins) {
+  const tables = {};
+  const extend = {};
+  const tableOwners = /* @__PURE__ */ new Map();
+  const fieldOwners = /* @__PURE__ */ new Map();
+  for (const plugin of plugins) {
+    if (!plugin.schema) {
+      continue;
+    }
+    if (plugin.schema.tables) {
+      for (const [tableName, tableDef] of Object.entries(
+        plugin.schema.tables
+      )) {
+        const existingOwner = tableOwners.get(tableName);
+        if (existingOwner !== void 0) {
+          throw new Error(
+            `Schema conflict: table "${tableName}" defined by both "${existingOwner}" and "${plugin.id}"`
+          );
+        }
+        tableOwners.set(tableName, plugin.id);
+        tables[tableName] = tableDef;
+      }
+    }
+    if (plugin.schema.extend) {
+      for (const [tableName, fields] of Object.entries(plugin.schema.extend)) {
+        let tableExtensions = extend[tableName];
+        if (tableExtensions === void 0) {
+          tableExtensions = {};
+          extend[tableName] = tableExtensions;
+        }
+        for (const [fieldName, fieldDef] of Object.entries(fields)) {
+          const key = `${tableName}.${fieldName}`;
+          const existingOwner = fieldOwners.get(key);
+          if (existingOwner !== void 0) {
+            throw new Error(
+              `Schema conflict: field "${tableName}.${fieldName}" extended by both "${existingOwner}" and "${plugin.id}"`
+            );
+          }
+          fieldOwners.set(key, plugin.id);
+          tableExtensions[fieldName] = fieldDef;
+        }
+      }
+    }
+  }
+  return { tables, extend };
 }
 
 // src/resolve-plugins.ts

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hook-registry.ts","../src/validation.ts","../src/schema.ts","../src/resolve-plugins.ts"],"sourcesContent":["import type { HookContract, HookHandlers } from \"./types.js\";\n\n/**\n * Error captured when a plugin hook handler fails during `invokeAfter`.\n */\nexport interface PluginError {\n  pluginId: string;\n  hook: string;\n  error: unknown;\n}\n\n/**\n * Error thrown by `invokeBefore` when a plugin hook handler fails.\n * Wraps the original error with plugin and hook context so callers\n * can identify which plugin caused the failure.\n */\nexport class PluginInvokeError extends Error {\n  override readonly name = \"PluginInvokeError\";\n  readonly pluginId: string;\n  readonly hook: string;\n\n  constructor(pluginId: string, hook: string, cause: unknown) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    super(`Plugin \"${pluginId}\" failed on hook \"${hook}\": ${detail}`, {\n      cause,\n    });\n    this.pluginId = pluginId;\n    this.hook = hook;\n  }\n}\n\n/**\n * Internal handler entry. The handler is typed as `(payload: never) => …`\n * because any function `(payload: T) => R` is assignable to it (contravariance\n * on `never`). This avoids a type assertion at registration time.\n */\ninterface RegisteredHook {\n  pluginId: string;\n  handler: (payload: never) => void | Promise<void>;\n}\n\n/**\n * Runtime registry that products use to register plugin hooks and invoke them\n * at lifecycle points.\n *\n * Generic over THooks so products get type-safe hook names and payloads.\n */\nexport class HookRegistry<THooks extends HookContract> {\n  private hooks = new Map<string, RegisteredHook[]>();\n  private registeredPlugins = new Set<string>();\n\n  /**\n   * Register all hooks declared by a plugin. Skips entries whose value is not\n   * a function (defensive against partial/optional declarations).\n   *\n   * Throws if a plugin with the same ID has already been registered.\n   */\n  register(pluginId: string, hooks: Partial<HookHandlers<THooks>>): void {\n    if (this.registeredPlugins.has(pluginId)) {\n      throw new Error(`Plugin \"${pluginId}\" is already registered`);\n    }\n    this.registeredPlugins.add(pluginId);\n\n    for (const [key, handler] of Object.entries(hooks)) {\n      if (typeof handler !== \"function\") {\n        continue;\n      }\n\n      let list = this.hooks.get(key);\n      if (list === undefined) {\n        list = [];\n        this.hooks.set(key, list);\n      }\n      list.push({ pluginId, handler });\n    }\n  }\n\n  /**\n   * Sequential, fail-fast invocation — for \"before\" hooks.\n   * Runs handlers in registration order. Aborts on first throw and wraps\n   * the error in a {@link PluginInvokeError} so the caller knows which\n   * plugin failed. Later handlers are **not** called.\n   *\n   * Uses a snapshot of the handler list so that registrations during\n   * async execution do not affect the current invocation.\n   */\n  async invokeBefore<K extends keyof THooks & string>(\n    hook: K,\n    payload: THooks[K],\n  ): Promise<void> {\n    const list = this.hooks.get(hook);\n    if (list === undefined) {\n      return;\n    }\n    const snapshot = [...list];\n    for (const entry of snapshot) {\n      try {\n        await this.callHandler(entry.handler, payload);\n      } catch (error: unknown) {\n        throw new PluginInvokeError(entry.pluginId, hook, error);\n      }\n    }\n  }\n\n  /**\n   * Sequential, collect-errors invocation — for \"after\" hooks.\n   * Runs **all** handlers even when some fail. Failures are wrapped in\n   * {@link PluginError} and returned as an array. Returns an empty array\n   * when all handlers succeed or when no handlers are registered.\n   *\n   * Uses a snapshot of the handler list so that registrations during\n   * async execution do not affect the current invocation.\n   */\n  async invokeAfter<K extends keyof THooks & string>(\n    hook: K,\n    payload: THooks[K],\n  ): Promise<PluginError[]> {\n    const list = this.hooks.get(hook);\n    if (list === undefined) {\n      return [];\n    }\n\n    const errors: PluginError[] = [];\n    const snapshot = [...list];\n    for (const entry of snapshot) {\n      try {\n        await this.callHandler(entry.handler, payload);\n      } catch (error: unknown) {\n        errors.push({\n          pluginId: entry.pluginId,\n          hook,\n          error,\n        });\n      }\n    }\n    return errors;\n  }\n\n  /**\n   * Calls a stored handler with the given payload.\n   *\n   * Handlers are stored as `(payload: never) => …` for variance compatibility\n   * (see {@link RegisteredHook}). At runtime the payload always matches\n   * `THooks[K]` — guaranteed by the generic constraint on {@link register}.\n   * This single assertion is the only place where TypeScript's type system\n   * cannot statically verify the heterogeneous map access.\n   */\n  private callHandler<K extends keyof THooks>(\n    handler: (payload: never) => void | Promise<void>,\n    payload: THooks[K],\n  ): void | Promise<void> {\n    return (handler as (p: THooks[K]) => void | Promise<void>)(payload);\n  }\n}\n","/**\n * Asserts that a value is not `undefined`.\n * Throws with a descriptive error message following the plugin config error pattern.\n */\nexport function assertDefined<T>(\n  value: T | undefined,\n  name: string,\n): asserts value is T {\n  if (value === undefined) {\n    throw new Error(`Plugin config error: \"${name}\" is required`);\n  }\n}\n\n/**\n * Asserts that a value is one of the allowed values.\n * Throws with a descriptive error message listing the allowed options.\n */\nexport function assertOneOf<T extends string | number | boolean>(value: T, allowed: T[], name: string): void {\n  if (!allowed.includes(value)) {\n    const allowedStr = allowed.join(\", \");\n    throw new Error(\n      `Plugin config error: \"${name}\" must be one of: ${allowedStr} (got: ${String(value)})`,\n    );\n  }\n}\n","import type {\n  HookContract,\n  PluginDefinition,\n  PluginFieldDefinition,\n  PluginTableDefinition,\n} from \"./types.js\";\n\n/**\n * Merged schema produced by combining all plugin schema declarations.\n * Unlike per-plugin `PluginSchema` (where fields are optional),\n * the merged result always contains both maps.\n */\nexport interface MergedPluginSchema {\n  tables: Record<string, PluginTableDefinition>;\n  extend: Record<string, Record<string, PluginFieldDefinition>>;\n}\n\n/**\n * Merges schema declarations from all plugins into a single result.\n *\n * Returns empty maps. Full merge logic (conflict detection, ordering)\n * will be added when schema merging is needed.\n */\nexport function mergeSchemas<THooks extends HookContract>(\n  _plugins: PluginDefinition<THooks>[],\n): MergedPluginSchema {\n  return { tables: {}, extend: {} };\n}\n","import { HookRegistry } from \"./hook-registry.js\";\nimport type { MergedPluginSchema } from \"./schema.js\";\nimport { mergeSchemas } from \"./schema.js\";\nimport type {\n  HookContract,\n  PluginContext,\n  PluginDefinition,\n  PluginEndpoint,\n} from \"./types.js\";\n\nexport class PluginInitError extends Error {\n  override readonly name = \"PluginInitError\";\n  readonly pluginId: string;\n\n  constructor(pluginId: string, cause: unknown) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    super(`Plugin \"${pluginId}\" failed during init: ${detail}`, { cause });\n    this.pluginId = pluginId;\n  }\n}\n\n/**\n * A collected endpoint annotated with the plugin that contributed it.\n */\nexport interface ResolvedEndpoint extends PluginEndpoint {\n  pluginId: string;\n}\n\n/**\n * Result of resolving a set of plugins. Contains the fully wired\n * hook registry, collected endpoints, merged schema, and plugin IDs.\n */\nexport interface ResolvedPlugins<THooks extends HookContract> {\n  hookRegistry: HookRegistry<THooks>;\n  endpoints: ResolvedEndpoint[];\n  schema: MergedPluginSchema;\n  pluginIds: string[];\n}\n\n/**\n * Lifecycle orchestrator that products call during construction.\n *\n * Steps:\n * 1. **Validate** — duplicate IDs throw immediately\n * 2. **Register hooks** — into a new HookRegistry\n * 3. **Collect endpoints** — flat array from all plugins\n * 4. **Merge schemas** — calls mergeSchemas\n * 5. **Init** — call plugin.init(ctx) sequentially in declaration order\n */\nexport async function resolvePlugins<THooks extends HookContract>(\n  productId: string,\n  plugins: PluginDefinition<THooks>[],\n  config: Record<string, unknown>,\n): Promise<ResolvedPlugins<THooks>> {\n  // 1. Validate — check for empty/whitespace IDs and duplicates\n  const seen = new Set<string>();\n  for (const plugin of plugins) {\n    if (!plugin.id || !plugin.id.trim()) {\n      throw new Error('Plugin config error: \"id\" is required');\n    }\n    if (plugin.id !== plugin.id.trim()) {\n      throw new Error(\n        `Plugin config error: \"id\" must not have leading or trailing whitespace (got: \"${plugin.id}\")`,\n      );\n    }\n    if (seen.has(plugin.id)) {\n      throw new Error(`Duplicate plugin ID: \"${plugin.id}\"`);\n    }\n    seen.add(plugin.id);\n  }\n\n  // 2. Register hooks\n  const hookRegistry = new HookRegistry<THooks>();\n  for (const plugin of plugins) {\n    if (plugin.hooks) {\n      hookRegistry.register(plugin.id, plugin.hooks);\n    }\n  }\n\n  // 3. Collect endpoints (annotated with pluginId)\n  const endpoints: ResolvedEndpoint[] = [];\n  for (const plugin of plugins) {\n    if (plugin.endpoints) {\n      for (const ep of plugin.endpoints) {\n        if (!ep.path || !ep.path.startsWith(\"/\")) {\n          throw new Error(\n            `Plugin \"${plugin.id}\" endpoint path must start with \"/\" (got: \"${ep.path}\")`,\n          );\n        }\n        endpoints.push({ ...ep, pluginId: plugin.id });\n      }\n    }\n  }\n\n  // 4. Merge schemas\n  const schema = mergeSchemas(plugins);\n\n  // 5. Init — sequential in declaration order\n  const pluginIds = plugins.map((p) => p.id);\n  const frozenConfig = Object.freeze({ ...config });\n  const context: PluginContext = {\n    productId,\n    hasPlugin: (id: string) => seen.has(id),\n    config: frozenConfig,\n  };\n\n  for (const plugin of plugins) {\n    if (plugin.init) {\n      try {\n        await plugin.init(context);\n      } catch (err) {\n        throw new PluginInitError(plugin.id, err);\n      }\n    }\n  }\n\n  return { hookRegistry, endpoints, schema, pluginIds };\n}\n"],"mappings":";AAgBO,IAAM,oBAAN,cAAgC,MAAM;AAAA,EACzB,OAAO;AAAA,EAChB;AAAA,EACA;AAAA,EAET,YAAY,UAAkB,MAAc,OAAgB;AAC1D,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,UAAM,WAAW,QAAQ,qBAAqB,IAAI,MAAM,MAAM,IAAI;AAAA,MAChE;AAAA,IACF,CAAC;AACD,SAAK,WAAW;AAChB,SAAK,OAAO;AAAA,EACd;AACF;AAkBO,IAAM,eAAN,MAAgD;AAAA,EAC7C,QAAQ,oBAAI,IAA8B;AAAA,EAC1C,oBAAoB,oBAAI,IAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ5C,SAAS,UAAkB,OAA4C;AACrE,QAAI,KAAK,kBAAkB,IAAI,QAAQ,GAAG;AACxC,YAAM,IAAI,MAAM,WAAW,QAAQ,yBAAyB;AAAA,IAC9D;AACA,SAAK,kBAAkB,IAAI,QAAQ;AAEnC,eAAW,CAAC,KAAK,OAAO,KAAK,OAAO,QAAQ,KAAK,GAAG;AAClD,UAAI,OAAO,YAAY,YAAY;AACjC;AAAA,MACF;AAEA,UAAI,OAAO,KAAK,MAAM,IAAI,GAAG;AAC7B,UAAI,SAAS,QAAW;AACtB,eAAO,CAAC;AACR,aAAK,MAAM,IAAI,KAAK,IAAI;AAAA,MAC1B;AACA,WAAK,KAAK,EAAE,UAAU,QAAQ,CAAC;AAAA,IACjC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,aACJ,MACA,SACe;AACf,UAAM,OAAO,KAAK,MAAM,IAAI,IAAI;AAChC,QAAI,SAAS,QAAW;AACtB;AAAA,IACF;AACA,UAAM,WAAW,CAAC,GAAG,IAAI;AACzB,eAAW,SAAS,UAAU;AAC5B,UAAI;AACF,cAAM,KAAK,YAAY,MAAM,SAAS,OAAO;AAAA,MAC/C,SAAS,OAAgB;AACvB,cAAM,IAAI,kBAAkB,MAAM,UAAU,MAAM,KAAK;AAAA,MACzD;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,YACJ,MACA,SACwB;AACxB,UAAM,OAAO,KAAK,MAAM,IAAI,IAAI;AAChC,QAAI,SAAS,QAAW;AACtB,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,SAAwB,CAAC;AAC/B,UAAM,WAAW,CAAC,GAAG,IAAI;AACzB,eAAW,SAAS,UAAU;AAC5B,UAAI;AACF,cAAM,KAAK,YAAY,MAAM,SAAS,OAAO;AAAA,MAC/C,SAAS,OAAgB;AACvB,eAAO,KAAK;AAAA,UACV,UAAU,MAAM;AAAA,UAChB;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWQ,YACN,SACA,SACsB;AACtB,WAAQ,QAAmD,OAAO;AAAA,EACpE;AACF;;;ACrJO,SAAS,cACd,OACA,MACoB;AACpB,MAAI,UAAU,QAAW;AACvB,UAAM,IAAI,MAAM,yBAAyB,IAAI,eAAe;AAAA,EAC9D;AACF;AAMO,SAAS,YAAiD,OAAU,SAAc,MAAoB;AAC3G,MAAI,CAAC,QAAQ,SAAS,KAAK,GAAG;AAC5B,UAAM,aAAa,QAAQ,KAAK,IAAI;AACpC,UAAM,IAAI;AAAA,MACR,yBAAyB,IAAI,qBAAqB,UAAU,UAAU,OAAO,KAAK,CAAC;AAAA,IACrF;AAAA,EACF;AACF;;;ACDO,SAAS,aACd,UACoB;AACpB,SAAO,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE;AAClC;;;ACjBO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACvB,OAAO;AAAA,EAChB;AAAA,EAET,YAAY,UAAkB,OAAgB;AAC5C,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,UAAM,WAAW,QAAQ,yBAAyB,MAAM,IAAI,EAAE,MAAM,CAAC;AACrE,SAAK,WAAW;AAAA,EAClB;AACF;AA8BA,eAAsB,eACpB,WACA,SACA,QACkC;AAElC,QAAM,OAAO,oBAAI,IAAY;AAC7B,aAAW,UAAU,SAAS;AAC5B,QAAI,CAAC,OAAO,MAAM,CAAC,OAAO,GAAG,KAAK,GAAG;AACnC,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AACA,QAAI,OAAO,OAAO,OAAO,GAAG,KAAK,GAAG;AAClC,YAAM,IAAI;AAAA,QACR,iFAAiF,OAAO,EAAE;AAAA,MAC5F;AAAA,IACF;AACA,QAAI,KAAK,IAAI,OAAO,EAAE,GAAG;AACvB,YAAM,IAAI,MAAM,yBAAyB,OAAO,EAAE,GAAG;AAAA,IACvD;AACA,SAAK,IAAI,OAAO,EAAE;AAAA,EACpB;AAGA,QAAM,eAAe,IAAI,aAAqB;AAC9C,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,OAAO;AAChB,mBAAa,SAAS,OAAO,IAAI,OAAO,KAAK;AAAA,IAC/C;AAAA,EACF;AAGA,QAAM,YAAgC,CAAC;AACvC,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,WAAW;AACpB,iBAAW,MAAM,OAAO,WAAW;AACjC,YAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,KAAK,WAAW,GAAG,GAAG;AACxC,gBAAM,IAAI;AAAA,YACR,WAAW,OAAO,EAAE,8CAA8C,GAAG,IAAI;AAAA,UAC3E;AAAA,QACF;AACA,kBAAU,KAAK,EAAE,GAAG,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,MAC/C;AAAA,IACF;AAAA,EACF;AAGA,QAAM,SAAS,aAAa,OAAO;AAGnC,QAAM,YAAY,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE;AACzC,QAAM,eAAe,OAAO,OAAO,EAAE,GAAG,OAAO,CAAC;AAChD,QAAM,UAAyB;AAAA,IAC7B;AAAA,IACA,WAAW,CAAC,OAAe,KAAK,IAAI,EAAE;AAAA,IACtC,QAAQ;AAAA,EACV;AAEA,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,MAAM;AACf,UAAI;AACF,cAAM,OAAO,KAAK,OAAO;AAAA,MAC3B,SAAS,KAAK;AACZ,cAAM,IAAI,gBAAgB,OAAO,IAAI,GAAG;AAAA,MAC1C;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,cAAc,WAAW,QAAQ,UAAU;AACtD;","names":[]}
+{"version":3,"sources":["../src/hook-registry.ts","../src/validation.ts","../src/schema.ts","../src/resolve-plugins.ts"],"sourcesContent":["import type { HookContract, HookHandlers } from \"./types.js\";\n\n/**\n * Error captured when a plugin hook handler fails during `invokeAfter`.\n */\nexport interface PluginError {\n  pluginId: string;\n  hook: string;\n  error: unknown;\n}\n\n/**\n * Error thrown by `invokeBefore` when a plugin hook handler fails.\n * Wraps the original error with plugin and hook context so callers\n * can identify which plugin caused the failure.\n */\nexport class PluginInvokeError extends Error {\n  override readonly name = \"PluginInvokeError\";\n  readonly pluginId: string;\n  readonly hook: string;\n\n  constructor(pluginId: string, hook: string, cause: unknown) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    super(`Plugin \"${pluginId}\" failed on hook \"${hook}\": ${detail}`, {\n      cause,\n    });\n    this.pluginId = pluginId;\n    this.hook = hook;\n  }\n}\n\n/**\n * Internal handler entry. The handler is typed as `(payload: never) => …`\n * because any function `(payload: T) => R` is assignable to it (contravariance\n * on `never`). This avoids a type assertion at registration time.\n */\ninterface RegisteredHook {\n  pluginId: string;\n  handler: (payload: never) => void | Promise<void>;\n}\n\n/**\n * Runtime registry that products use to register plugin hooks and invoke them\n * at lifecycle points.\n *\n * Generic over THooks so products get type-safe hook names and payloads.\n */\nexport class HookRegistry<THooks extends HookContract> {\n  private hooks = new Map<string, RegisteredHook[]>();\n  private registeredPlugins = new Set<string>();\n\n  /**\n   * Register all hooks declared by a plugin. Skips entries whose value is not\n   * a function (defensive against partial/optional declarations).\n   *\n   * Throws if a plugin with the same ID has already been registered.\n   */\n  register(pluginId: string, hooks: Partial<HookHandlers<THooks>>): void {\n    if (this.registeredPlugins.has(pluginId)) {\n      throw new Error(`Plugin \"${pluginId}\" is already registered`);\n    }\n    this.registeredPlugins.add(pluginId);\n\n    for (const [key, handler] of Object.entries(hooks)) {\n      if (typeof handler !== \"function\") {\n        continue;\n      }\n\n      let list = this.hooks.get(key);\n      if (list === undefined) {\n        list = [];\n        this.hooks.set(key, list);\n      }\n      list.push({ pluginId, handler });\n    }\n  }\n\n  /**\n   * Sequential, fail-fast invocation — for \"before\" hooks.\n   * Runs handlers in registration order. Aborts on first throw and wraps\n   * the error in a {@link PluginInvokeError} so the caller knows which\n   * plugin failed. Later handlers are **not** called.\n   *\n   * Uses a snapshot of the handler list so that registrations during\n   * async execution do not affect the current invocation.\n   */\n  async invokeBefore<K extends keyof THooks & string>(\n    hook: K,\n    payload: THooks[K],\n  ): Promise<void> {\n    const list = this.hooks.get(hook);\n    if (list === undefined) {\n      return;\n    }\n    const snapshot = [...list];\n    for (const entry of snapshot) {\n      try {\n        await this.callHandler(entry.handler, payload);\n      } catch (error: unknown) {\n        throw new PluginInvokeError(entry.pluginId, hook, error);\n      }\n    }\n  }\n\n  /**\n   * Sequential, collect-errors invocation — for \"after\" hooks.\n   * Runs **all** handlers even when some fail. Failures are wrapped in\n   * {@link PluginError} and returned as an array. Returns an empty array\n   * when all handlers succeed or when no handlers are registered.\n   *\n   * Uses a snapshot of the handler list so that registrations during\n   * async execution do not affect the current invocation.\n   */\n  async invokeAfter<K extends keyof THooks & string>(\n    hook: K,\n    payload: THooks[K],\n  ): Promise<PluginError[]> {\n    const list = this.hooks.get(hook);\n    if (list === undefined) {\n      return [];\n    }\n\n    const errors: PluginError[] = [];\n    const snapshot = [...list];\n    for (const entry of snapshot) {\n      try {\n        await this.callHandler(entry.handler, payload);\n      } catch (error: unknown) {\n        errors.push({\n          pluginId: entry.pluginId,\n          hook,\n          error,\n        });\n      }\n    }\n    return errors;\n  }\n\n  /**\n   * Calls a stored handler with the given payload.\n   *\n   * Handlers are stored as `(payload: never) => …` for variance compatibility\n   * (see {@link RegisteredHook}). At runtime the payload always matches\n   * `THooks[K]` — guaranteed by the generic constraint on {@link register}.\n   * This single assertion is the only place where TypeScript's type system\n   * cannot statically verify the heterogeneous map access.\n   */\n  private callHandler<K extends keyof THooks>(\n    handler: (payload: never) => void | Promise<void>,\n    payload: THooks[K],\n  ): void | Promise<void> {\n    return (handler as (p: THooks[K]) => void | Promise<void>)(payload);\n  }\n}\n","/**\n * Asserts that a value is not `undefined`.\n * Throws with a descriptive error message following the plugin config error pattern.\n */\nexport function assertDefined<T>(\n  value: T | undefined,\n  name: string,\n): asserts value is T {\n  if (value === undefined) {\n    throw new Error(`Plugin config error: \"${name}\" is required`);\n  }\n}\n\n/**\n * Asserts that a value is one of the allowed values.\n * Throws with a descriptive error message listing the allowed options.\n */\nexport function assertOneOf<T extends string | number | boolean>(value: T, allowed: T[], name: string): void {\n  if (!allowed.includes(value)) {\n    const allowedStr = allowed.join(\", \");\n    throw new Error(\n      `Plugin config error: \"${name}\" must be one of: ${allowedStr} (got: ${String(value)})`,\n    );\n  }\n}\n","import type {\n  HookContract,\n  PluginDefinition,\n  PluginFieldDefinition,\n  PluginTableDefinition,\n} from \"./types.js\";\n\n/**\n * Merged schema produced by combining all plugin schema declarations.\n * Unlike per-plugin `PluginSchema` (where fields are optional),\n * the merged result always contains both maps.\n */\nexport interface MergedPluginSchema {\n  tables: Record<string, PluginTableDefinition>;\n  extend: Record<string, Record<string, PluginFieldDefinition>>;\n}\n\n/**\n * Merges schema declarations from all plugins into a single result.\n *\n * Iterates plugins in declaration order and collects new tables and\n * extended fields. Throws on conflicts:\n * - Two plugins defining the same table name\n * - Two plugins extending the same field on the same table\n */\nexport function mergeSchemas<THooks extends HookContract>(\n  plugins: PluginDefinition<THooks>[],\n): MergedPluginSchema {\n  const tables: Record<string, PluginTableDefinition> = {};\n  const extend: Record<string, Record<string, PluginFieldDefinition>> = {};\n\n  const tableOwners = new Map<string, string>();\n  const fieldOwners = new Map<string, string>();\n\n  for (const plugin of plugins) {\n    if (!plugin.schema) {\n      continue;\n    }\n\n    if (plugin.schema.tables) {\n      for (const [tableName, tableDef] of Object.entries(\n        plugin.schema.tables,\n      )) {\n        const existingOwner = tableOwners.get(tableName);\n        if (existingOwner !== undefined) {\n          throw new Error(\n            `Schema conflict: table \"${tableName}\" defined by both \"${existingOwner}\" and \"${plugin.id}\"`,\n          );\n        }\n        tableOwners.set(tableName, plugin.id);\n        tables[tableName] = tableDef;\n      }\n    }\n\n    if (plugin.schema.extend) {\n      for (const [tableName, fields] of Object.entries(plugin.schema.extend)) {\n        let tableExtensions = extend[tableName];\n        if (tableExtensions === undefined) {\n          tableExtensions = {};\n          extend[tableName] = tableExtensions;\n        }\n\n        for (const [fieldName, fieldDef] of Object.entries(fields)) {\n          const key = `${tableName}.${fieldName}`;\n          const existingOwner = fieldOwners.get(key);\n          if (existingOwner !== undefined) {\n            throw new Error(\n              `Schema conflict: field \"${tableName}.${fieldName}\" extended by both \"${existingOwner}\" and \"${plugin.id}\"`,\n            );\n          }\n          fieldOwners.set(key, plugin.id);\n          tableExtensions[fieldName] = fieldDef;\n        }\n      }\n    }\n  }\n\n  return { tables, extend };\n}\n","import { HookRegistry } from \"./hook-registry.js\";\nimport type { MergedPluginSchema } from \"./schema.js\";\nimport { mergeSchemas } from \"./schema.js\";\nimport type {\n  HookContract,\n  PluginContext,\n  PluginDefinition,\n  PluginEndpoint,\n} from \"./types.js\";\n\nexport class PluginInitError extends Error {\n  override readonly name = \"PluginInitError\";\n  readonly pluginId: string;\n\n  constructor(pluginId: string, cause: unknown) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    super(`Plugin \"${pluginId}\" failed during init: ${detail}`, { cause });\n    this.pluginId = pluginId;\n  }\n}\n\n/**\n * A collected endpoint annotated with the plugin that contributed it.\n */\nexport interface ResolvedEndpoint extends PluginEndpoint {\n  pluginId: string;\n}\n\n/**\n * Result of resolving a set of plugins. Contains the fully wired\n * hook registry, collected endpoints, merged schema, and plugin IDs.\n */\nexport interface ResolvedPlugins<THooks extends HookContract> {\n  hookRegistry: HookRegistry<THooks>;\n  endpoints: ResolvedEndpoint[];\n  schema: MergedPluginSchema;\n  pluginIds: string[];\n}\n\n/**\n * Lifecycle orchestrator that products call during construction.\n *\n * Steps:\n * 1. **Validate** — duplicate IDs throw immediately\n * 2. **Register hooks** — into a new HookRegistry\n * 3. **Collect endpoints** — flat array from all plugins\n * 4. **Merge schemas** — calls mergeSchemas\n * 5. **Init** — call plugin.init(ctx) sequentially in declaration order\n */\nexport async function resolvePlugins<THooks extends HookContract>(\n  productId: string,\n  plugins: PluginDefinition<THooks>[],\n  config: Record<string, unknown>,\n): Promise<ResolvedPlugins<THooks>> {\n  // 1. Validate — check for empty/whitespace IDs and duplicates\n  const seen = new Set<string>();\n  for (const plugin of plugins) {\n    if (!plugin.id || !plugin.id.trim()) {\n      throw new Error('Plugin config error: \"id\" is required');\n    }\n    if (plugin.id !== plugin.id.trim()) {\n      throw new Error(\n        `Plugin config error: \"id\" must not have leading or trailing whitespace (got: \"${plugin.id}\")`,\n      );\n    }\n    if (seen.has(plugin.id)) {\n      throw new Error(`Duplicate plugin ID: \"${plugin.id}\"`);\n    }\n    seen.add(plugin.id);\n  }\n\n  // 2. Register hooks\n  const hookRegistry = new HookRegistry<THooks>();\n  for (const plugin of plugins) {\n    if (plugin.hooks) {\n      hookRegistry.register(plugin.id, plugin.hooks);\n    }\n  }\n\n  // 3. Collect endpoints (annotated with pluginId)\n  const endpoints: ResolvedEndpoint[] = [];\n  for (const plugin of plugins) {\n    if (plugin.endpoints) {\n      for (const ep of plugin.endpoints) {\n        if (!ep.path || !ep.path.startsWith(\"/\")) {\n          throw new Error(\n            `Plugin \"${plugin.id}\" endpoint path must start with \"/\" (got: \"${ep.path}\")`,\n          );\n        }\n        endpoints.push({ ...ep, pluginId: plugin.id });\n      }\n    }\n  }\n\n  // 4. Merge schemas\n  const schema = mergeSchemas(plugins);\n\n  // 5. Init — sequential in declaration order\n  const pluginIds = plugins.map((p) => p.id);\n  const frozenConfig = Object.freeze({ ...config });\n  const context: PluginContext = {\n    productId,\n    hasPlugin: (id: string) => seen.has(id),\n    config: frozenConfig,\n  };\n\n  for (const plugin of plugins) {\n    if (plugin.init) {\n      try {\n        await plugin.init(context);\n      } catch (err) {\n        throw new PluginInitError(plugin.id, err);\n      }\n    }\n  }\n\n  return { hookRegistry, endpoints, schema, pluginIds };\n}\n"],"mappings":"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","names":[]}

package/dist/schema.d.ts

@@ -11,8 +11,10 @@ export interface MergedPluginSchema {
 /**
  * Merges schema declarations from all plugins into a single result.
  *
- * Returns empty maps. Full merge logic (conflict detection, ordering)
- * will be added when schema merging is needed.
+ * Iterates plugins in declaration order and collects new tables and
+ * extended fields. Throws on conflicts:
+ * - Two plugins defining the same table name
+ * - Two plugins extending the same field on the same table
  */
-export declare function mergeSchemas<THooks extends HookContract>(_plugins: PluginDefinition<THooks>[]): MergedPluginSchema;
+export declare function mergeSchemas<THooks extends HookContract>(plugins: PluginDefinition<THooks>[]): MergedPluginSchema;
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,YAAY,EACtD,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,GACnC,kBAAkB,CAEpB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,YAAY,EACtD,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAClC,kBAAkB,CAmDpB"}

package/dist/types.d.ts

@@ -1,93 +1,2 @@
-/**
- * A contract mapping hook names to their payload shapes.
- * Products define this to declare what hooks are available.
- *
- * Example:
- * ```ts
- * type MyHooks = {
- *   "tenant:created": { tenantId: string; name: string };
- *   "tenant:deleted": { tenantId: string };
- * };
- * ```
- */
-export type HookContract = Record<string, Record<string, unknown>>;
-/**
- * Derives handler function signatures from a HookContract.
- * Each key becomes a handler that receives the corresponding payload.
- */
-export type HookHandlers<T extends HookContract> = {
-    [K in keyof T]: (payload: T[K]) => void | Promise<void>;
-};
-/**
- * Runtime context passed to plugin init functions.
- * Provides product identity, peer plugin awareness, and configuration.
- */
-export interface PluginContext {
-    productId: string;
-    hasPlugin: (id: string) => boolean;
-    config: Record<string, unknown>;
-}
-/** Common database column types that plugins can declare. */
-export type FieldType = "string" | "number" | "boolean" | "date" | "json";
-/** A single column definition within a plugin table. */
-export interface PluginFieldDefinition {
-    type: FieldType;
-    required?: boolean;
-    unique?: boolean;
-    defaultValue?: string | number | boolean | null | (() => unknown);
-    references?: {
-        table: string;
-        field: string;
-        onDelete?: "cascade" | "restrict" | "set-null" | "no-action";
-    };
-    index?: boolean;
-}
-/** A single table definition declared by a plugin. Keyed by field name. */
-export interface PluginTableDefinition {
-    fields: Record<string, PluginFieldDefinition>;
-}
-/**
- * Schema declaration for a plugin.
- * `tables` declares new tables (keyed by table name).
- * `extend` adds fields to existing product tables (keyed by table name, then field name).
- */
-export interface PluginSchema {
-    tables?: Record<string, PluginTableDefinition>;
-    extend?: Record<string, Record<string, PluginFieldDefinition>>;
-}
-/** HTTP methods that plugin endpoints can handle. */
-export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-/** Incoming request context provided to endpoint handlers. */
-export interface PluginRequestContext {
-    request: Request;
-    params: Record<string, string>;
-    body: unknown;
-    hasPlugin: (id: string) => boolean;
-}
-/** Response shape returned by endpoint handlers. */
-export interface PluginResponse {
-    status: number;
-    body: unknown;
-}
-/** Handler function signature for plugin endpoints. */
-export type PluginEndpointHandler = (context: PluginRequestContext) => Promise<PluginResponse>;
-/** A single HTTP endpoint declared by a plugin. */
-export interface PluginEndpoint {
-    method: HttpMethod;
-    path: string;
-    handler: PluginEndpointHandler;
-}
-/**
- * Full plugin definition. Generic over the hook contract so plugins
- * get type-safe hook handlers when a product provides its contract.
- */
-export interface PluginDefinition<THooks extends HookContract = HookContract> {
-    id: string;
-    init?: (context: PluginContext) => void | Promise<void>;
-    hooks?: Partial<HookHandlers<THooks>>;
-    schema?: PluginSchema;
-    endpoints?: PluginEndpoint[];
-    /** Type-level brand for inference. Not used at runtime. */
-    $Infer?: Record<string, unknown>;
-}
+export type { HookContract, HookHandlers, PluginContext, FieldType, PluginFieldDefinition, PluginTableDefinition, PluginSchema, HttpMethod, PluginRequestContext, PluginResponse, PluginEndpointHandler, PluginEndpoint, PluginDefinition, } from "@usebetterdev/contract/plugin-types";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,YAAY,IAAI;KAChD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CACxD,CAAC;AAMF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAMD,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1E,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IAClE,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;KAC9D,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;CAChE;AAMD,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAMD;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAC/B,MAAM,SAAS,YAAY,GAAG,YAAY;IAE1C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,qCAAqC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usebetterdev/plugin",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "repository": "github:usebetter-dev/usebetter",
   "bugs": "https://github.com/usebetter-dev/usebetter/issues",
   "homepage": "https://github.com/usebetter-dev/usebetter#readme",
@@ -17,12 +17,21 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "require": "./dist/config.cjs"
     }
   },
   "files": [
     "dist",
     "README.md"
   ],
+  "dependencies": {
+    "c12": "^2.0.1",
+    "@usebetterdev/contract": "0.6.0"
+  },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "tsup": "^8.3.5",