@usebetterdev/contract 0.5.0 → 0.6.0

package/LICENSE

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

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

@@ -1,4 +1,4 @@
-import type { PluginDefinition } from "@usebetterdev/plugin";
+import type { PluginDefinition } from "./plugin-types.js";
 /** Retention policy controlling automatic and CLI-driven purge of old audit logs. */
 export interface RetentionPolicy {
     /** Purge entries older than this many days. Must be a positive integer. */

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

@@ -1 +1 @@
-{"version":3,"file":"config-types-audit.d.ts","sourceRoot":"","sources":["../src/config-types-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,yHAAyH;IACzH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B"}
+{"version":3,"file":"config-types-audit.d.ts","sourceRoot":"","sources":["../src/config-types-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,yHAAyH;IACzH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B"}

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

@@ -1,4 +1,4 @@
-import type { PluginDefinition } from "@usebetterdev/plugin";
+import type { PluginDefinition } from "./plugin-types.js";
 /** Telemetry options. On by default; set enabled: false to opt out. */
 export interface TelemetryConfig {
     enabled?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"config-types-tenant.d.ts","sourceRoot":"","sources":["../src/config-types-tenant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,yDAAyD;AACzD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;IACnC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAAC;CACxC;AAED,qDAAqD;AACrD,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sIAAsI;IACtI,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B"}
+{"version":3,"file":"config-types-tenant.d.ts","sourceRoot":"","sources":["../src/config-types-tenant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,yDAAyD;AACzD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;IACnC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAAC;CACxC;AAED,qDAAqD;AACrD,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sIAAsI;IACtI,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B"}

package/dist/config-types.d.cts

@@ -1,4 +1,4 @@
-import { PluginDefinition } from '@usebetterdev/plugin';
+import { PluginDefinition } from './plugin-types.cjs';
 
 /** Telemetry options. On by default; set enabled: false to opt out. */
 interface TelemetryConfig {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/** Permission levels for console access. */\nexport type ConsolePermission = \"read\" | \"write\" | \"admin\";\n\n/** Minimal session info exposed to product handlers. */\nexport interface ConsoleProductSession {\n  id: string;\n  email: string;\n  permissions: ConsolePermission;\n}\n\n/**\n * Request object passed to product endpoint handlers.\n * Constructed by the console after authentication — session is always present.\n */\nexport interface ConsoleProductRequest {\n  params: Record<string, string>;\n  query: Record<string, string>;\n  body: unknown;\n  session: ConsoleProductSession;\n}\n\n/** Standardized response from endpoint handlers. */\nexport interface ConsoleResponse {\n  status: number;\n  body: unknown;\n  headers?: Record<string, string>;\n}\n\n/** A single endpoint registered by a product. */\nexport interface ConsoleProductEndpoint {\n  method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n  /** Path relative to the product mount, e.g. \"/tenants\" or \"/logs/:id\". */\n  path: string;\n  handler: (request: ConsoleProductRequest) => Promise<ConsoleResponse>;\n  requiredPermission?: ConsolePermission;\n}\n\n/** Product definition registered with the console. */\nexport interface ConsoleProduct {\n  /** Short identifier, e.g. \"tenant\", \"audit\". */\n  id: string;\n  /** Display name, e.g. \"Better Tenant\". */\n  name: string;\n  endpoints: ConsoleProductEndpoint[];\n}\n\n/** Interface products use to register with the console. */\nexport interface ConsoleRegistration {\n  registerProduct(product: ConsoleProduct): void;\n}\n\n// Re-export well-known endpoint types\nexport type {\n  HealthResponse,\n  CapabilitiesResponse,\n  SessionInitRequest,\n  SessionInitResponse,\n  SessionVerifyRequest,\n  SessionVerifyResponse,\n  SessionPollRequest,\n  SessionPollResponse,\n  SessionClaimRequest,\n  SessionClaimResponse,\n} from \"./wellknown-types.js\";\n\n// Re-export wire-format types for product endpoints\nexport type {\n  ConsoleErrorResponse,\n  AuditLogWire,\n  AuditLogsResponse,\n  AuditLogResponse,\n  AuditStatsResponse,\n  AuditEnrichmentSummary,\n  AuditEnrichmentsResponse,\n  AuditPurgeResponse,\n  AuditPurgeRequest,\n  AuditLogsQuery,\n  AuditStatsQuery,\n  TenantWire,\n  TenantsResponse,\n  TenantResponse,\n  CreateTenantRequest,\n  UpdateTenantRequest,\n  TenantStatsResponse,\n  TenantsQuery,\n} from \"./product-types.js\";\n\n// Re-export shared config types\nexport type {\n  TelemetryConfig,\n  PathResolverConfig,\n  SubdomainResolverConfig,\n  RetentionPolicy,\n  StaticJwtResolverConfig,\n  StaticTenantResolverConfig,\n  BetterTenantStaticConfig,\n  BetterAuditStaticConfig,\n  StaticMagicLinkConfig,\n  StaticConsoleSessionConfig,\n  BetterConsoleStaticConfig,\n  BetterConfig,\n} from \"./config-types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/** Permission levels for console access. */\nexport type ConsolePermission = \"read\" | \"write\" | \"admin\";\n\n/** Minimal session info exposed to product handlers. */\nexport interface ConsoleProductSession {\n  id: string;\n  email: string;\n  permissions: ConsolePermission;\n}\n\n/**\n * Request object passed to product endpoint handlers.\n * Constructed by the console after authentication — session is always present.\n */\nexport interface ConsoleProductRequest {\n  params: Record<string, string>;\n  query: Record<string, string>;\n  body: unknown;\n  session: ConsoleProductSession;\n}\n\n/** Standardized response from endpoint handlers. */\nexport interface ConsoleResponse {\n  status: number;\n  body: unknown;\n  headers?: Record<string, string>;\n}\n\n/** A single endpoint registered by a product. */\nexport interface ConsoleProductEndpoint {\n  method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n  /** Path relative to the product mount, e.g. \"/tenants\" or \"/logs/:id\". */\n  path: string;\n  handler: (request: ConsoleProductRequest) => Promise<ConsoleResponse>;\n  requiredPermission?: ConsolePermission;\n}\n\n/** Product definition registered with the console. */\nexport interface ConsoleProduct {\n  /** Short identifier, e.g. \"tenant\", \"audit\". */\n  id: string;\n  /** Display name, e.g. \"Better Tenant\". */\n  name: string;\n  endpoints: ConsoleProductEndpoint[];\n}\n\n/** Interface products use to register with the console. */\nexport interface ConsoleRegistration {\n  registerProduct(product: ConsoleProduct): void;\n}\n\n// Re-export well-known endpoint types\nexport type {\n  HealthResponse,\n  CapabilitiesResponse,\n  SessionInitRequest,\n  SessionInitResponse,\n  SessionVerifyRequest,\n  SessionVerifyResponse,\n  SessionPollRequest,\n  SessionPollResponse,\n  SessionClaimRequest,\n  SessionClaimResponse,\n} from \"./wellknown-types.js\";\n\n// Re-export wire-format types for product endpoints\nexport type {\n  ConsoleErrorResponse,\n  AuditLogWire,\n  AuditLogsResponse,\n  AuditLogResponse,\n  AuditStatsResponse,\n  AuditEnrichmentSummary,\n  AuditEnrichmentsResponse,\n  AuditPurgeResponse,\n  AuditPurgeRequest,\n  AuditLogsQuery,\n  AuditStatsQuery,\n  TenantWire,\n  TenantsResponse,\n  TenantResponse,\n  CreateTenantRequest,\n  UpdateTenantRequest,\n  TenantStatsResponse,\n  TenantsQuery,\n} from \"./product-types.js\";\n\n// Re-export plugin types\nexport 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 \"./plugin-types.js\";\n\n// Re-export shared config types\nexport type {\n  TelemetryConfig,\n  PathResolverConfig,\n  SubdomainResolverConfig,\n  RetentionPolicy,\n  StaticJwtResolverConfig,\n  StaticTenantResolverConfig,\n  BetterTenantStaticConfig,\n  BetterAuditStaticConfig,\n  StaticMagicLinkConfig,\n  StaticConsoleSessionConfig,\n  BetterConsoleStaticConfig,\n  BetterConfig,\n} from \"./config-types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/index.d.cts

@@ -1,3 +1,3 @@
 export { AuditEnrichmentSummary, AuditEnrichmentsResponse, AuditLogResponse, AuditLogWire, AuditLogsQuery, AuditLogsResponse, AuditPurgeRequest, AuditPurgeResponse, AuditStatsQuery, AuditStatsResponse, C as CapabilitiesResponse, ConsoleErrorResponse, ConsolePermission, a as ConsoleProduct, b as ConsoleProductEndpoint, c as ConsoleProductRequest, d as ConsoleProductSession, e as ConsoleRegistration, f as ConsoleResponse, CreateTenantRequest, H as HealthResponse, S as SessionClaimRequest, g as SessionClaimResponse, h as SessionInitRequest, i as SessionInitResponse, j as SessionPollRequest, k as SessionPollResponse, l as SessionVerifyRequest, m as SessionVerifyResponse, TenantResponse, TenantStatsResponse, TenantWire, TenantsQuery, TenantsResponse, UpdateTenantRequest } from './product-types.cjs';
+export { FieldType, HookContract, HookHandlers, HttpMethod, PluginContext, PluginDefinition, PluginEndpoint, PluginEndpointHandler, PluginFieldDefinition, PluginRequestContext, PluginResponse, PluginSchema, PluginTableDefinition } from './plugin-types.cjs';
 export { BetterAuditStaticConfig, BetterConfig, BetterConsoleStaticConfig, BetterTenantStaticConfig, PathResolverConfig, RetentionPolicy, StaticConsoleSessionConfig, StaticJwtResolverConfig, StaticMagicLinkConfig, StaticTenantResolverConfig, SubdomainResolverConfig, TelemetryConfig } from './config-types.cjs';
-import '@usebetterdev/plugin';

package/dist/index.d.ts

@@ -44,5 +44,6 @@ export interface ConsoleRegistration {
 }
 export type { HealthResponse, CapabilitiesResponse, SessionInitRequest, SessionInitResponse, SessionVerifyRequest, SessionVerifyResponse, SessionPollRequest, SessionPollResponse, SessionClaimRequest, SessionClaimResponse, } from "./wellknown-types.js";
 export type { ConsoleErrorResponse, AuditLogWire, AuditLogsResponse, AuditLogResponse, AuditStatsResponse, AuditEnrichmentSummary, AuditEnrichmentsResponse, AuditPurgeResponse, AuditPurgeRequest, AuditLogsQuery, AuditStatsQuery, TenantWire, TenantsResponse, TenantResponse, CreateTenantRequest, UpdateTenantRequest, TenantStatsResponse, TenantsQuery, } from "./product-types.js";
+export type { HookContract, HookHandlers, PluginContext, FieldType, PluginFieldDefinition, PluginTableDefinition, PluginSchema, HttpMethod, PluginRequestContext, PluginResponse, PluginEndpointHandler, PluginEndpoint, PluginDefinition, } from "./plugin-types.js";
 export type { TelemetryConfig, PathResolverConfig, SubdomainResolverConfig, RetentionPolicy, StaticJwtResolverConfig, StaticTenantResolverConfig, BetterTenantStaticConfig, BetterAuditStaticConfig, StaticMagicLinkConfig, StaticConsoleSessionConfig, BetterConsoleStaticConfig, BetterConfig, } 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,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;CACxC;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC;AAED,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CAChD;AAGD,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,UAAU,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,GACb,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;CACxC;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC;AAED,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CAChD;AAGD,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,UAAU,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,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,mBAAmB,CAAC;AAG3B,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,GACb,MAAM,mBAAmB,CAAC"}

package/dist/plugin-types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/plugin-types.ts
+var plugin_types_exports = {};
+module.exports = __toCommonJS(plugin_types_exports);
+//# sourceMappingURL=plugin-types.cjs.map

package/dist/plugin-types.cjs.map

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

package/dist/plugin-types.d.cts

@@ -0,0 +1,94 @@
+/**
+ * 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 };
+ * };
+ * ```
+ */
+type HookContract = Record<string, Record<string, unknown>>;
+/**
+ * Derives handler function signatures from a HookContract.
+ * Each key becomes a handler that receives the corresponding payload.
+ */
+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.
+ */
+interface PluginContext {
+    productId: string;
+    hasPlugin: (id: string) => boolean;
+    config: Record<string, unknown>;
+}
+/** Common database column types that plugins can declare. */
+type FieldType = "string" | "number" | "boolean" | "date" | "json";
+/** A single column definition within a plugin table. */
+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. */
+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).
+ */
+interface PluginSchema {
+    tables?: Record<string, PluginTableDefinition>;
+    extend?: Record<string, Record<string, PluginFieldDefinition>>;
+}
+/** HTTP methods that plugin endpoints can handle. */
+type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+/** Incoming request context provided to endpoint handlers. */
+interface PluginRequestContext {
+    request: Request;
+    params: Record<string, string>;
+    body: unknown;
+    hasPlugin: (id: string) => boolean;
+}
+/** Response shape returned by endpoint handlers. */
+interface PluginResponse {
+    status: number;
+    body: unknown;
+}
+/** Handler function signature for plugin endpoints. */
+type PluginEndpointHandler = (context: PluginRequestContext) => Promise<PluginResponse>;
+/** A single HTTP endpoint declared by a plugin. */
+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.
+ */
+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 { FieldType, HookContract, HookHandlers, HttpMethod, PluginContext, PluginDefinition, PluginEndpoint, PluginEndpointHandler, PluginFieldDefinition, PluginRequestContext, PluginResponse, PluginSchema, PluginTableDefinition };

package/dist/plugin-types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 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>;
+}
+//# sourceMappingURL=plugin-types.d.ts.map

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

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

package/dist/plugin-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=plugin-types.js.map

package/dist/plugin-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/product-types.d.cts

@@ -1,5 +1,5 @@
+import './plugin-types.cjs';
 import './config-types.cjs';
-import '@usebetterdev/plugin';
 
 /**
  * Wire-format types for console well-known endpoints.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usebetterdev/contract",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "repository": "github:usebetter-dev/usebetter",
   "bugs": "https://github.com/usebetter-dev/usebetter/issues",
   "homepage": "https://github.com/usebetter-dev/usebetter#readme",
@@ -27,25 +27,27 @@
       "types": "./dist/config-types.d.ts",
       "import": "./dist/config-types.js",
       "require": "./dist/config-types.cjs"
+    },
+    "./plugin-types": {
+      "types": "./dist/plugin-types.d.ts",
+      "import": "./dist/plugin-types.js",
+      "require": "./dist/plugin-types.cjs"
     }
   },
   "files": [
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsup",
-    "build:types": "tsc --build tsconfig.build.json",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@usebetterdev/plugin": "workspace:*"
-  },
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "~5.7.2"
   },
   "engines": {
     "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:types": "tsc --build tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
   }
-}
+}