@databricks/appkit 0.64.0 → 0.66.0

package/dist/database/schema-builder/fk.d.ts

@@ -0,0 +1,9 @@
+import { FkRef } from "./types.js";
+import { ColumnBuilder } from "./columns.js";
+
+//#region src/database/schema-builder/fk.d.ts
+/** Declare foreign-key to another column. */
+declare function fk(ref: FkRef): ColumnBuilder;
+//#endregion
+export { fk };
+//# sourceMappingURL=fk.d.ts.map

package/dist/database/schema-builder/fk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fk.d.ts","names":[],"sources":["../../../src/database/schema-builder/fk.ts"],"mappings":";;;;;iBAUgB,EAAA,CAAG,GAAA,EAAK,KAAA,GAAQ,aAAA"}

package/dist/database/schema-builder/fk.js

@@ -0,0 +1,71 @@
+import { SchemaBuildError } from "./types.js";
+import { ColumnBuilder } from "./columns.js";
+
+//#region src/database/schema-builder/fk.ts
+/** Declare foreign-key to another column. */
+function fk(ref) {
+	const builder = new ColumnBuilder({ kind: "fk" }, "number");
+	builder._meta.fkRef = ref;
+	return builder;
+}
+function resolveFkRef(ref) {
+	const resolved = typeof ref === "function" ? ref() : ref;
+	if (!resolved || typeof resolved !== "object" || resolved.__isColumnRef !== true) throw new SchemaBuildError("fk() must reference a column created by table()");
+	return resolved;
+}
+/** A serial PK target stores as its plain integer type on the FK side. */
+function mirrorStorageKind(targetStorage) {
+	if (targetStorage === "id") return "integer";
+	if (targetStorage === "bigid") return "bigint";
+	return targetStorage;
+}
+/** Resolve FK identity, inherited storage, and action invariants in one pass. */
+function resolveForeignKeys(tables) {
+	const references = /* @__PURE__ */ new Map();
+	for (const table of tables.values()) for (const [columnName, reference] of Object.entries(table.handle)) {
+		const meta = table.metas[columnName];
+		if (!meta) throw new SchemaBuildError(`Column reference "${table.name}.${columnName}" has no metadata`);
+		references.set(reference, {
+			table,
+			meta
+		});
+	}
+	const resolving = /* @__PURE__ */ new Set();
+	const resolved = /* @__PURE__ */ new Set();
+	const resolveForeignKey = (table, meta) => {
+		if (!meta.fkRef || resolved.has(meta)) return;
+		if (resolving.has(meta)) throw new SchemaBuildError(`Foreign key "${table.name}.${meta.columnName}" has a cyclic storage dependency`);
+		resolving.add(meta);
+		try {
+			const reference = resolveFkRef(meta.fkRef);
+			const targetIdentity = references.get(reference);
+			if (!targetIdentity) throw new SchemaBuildError(`fk() on "${table.name}.${meta.columnName}" targets a column outside the returned schema`);
+			const { table: targetTable, meta: target } = targetIdentity;
+			resolveForeignKey(targetTable, target);
+			if (!target.primaryKey && !target.unique) throw new SchemaBuildError(`fk() on "${table.name}.${meta.columnName}" must target a primary-key or unique column`);
+			meta.storageKind = mirrorStorageKind(target.storageKind);
+			meta.kind = target.kind;
+			meta.withTimezone = target.withTimezone;
+			meta.varcharLength = target.varcharLength;
+			meta.enumName = target.enumName;
+			meta.enumValues = target.enumValues ? Object.freeze([...target.enumValues]) : void 0;
+			meta.fk = {
+				targetTable: targetTable.name,
+				targetColumn: target.columnName,
+				onDelete: meta.onDelete,
+				onUpdate: meta.onUpdate
+			};
+			const actions = [meta.onDelete, meta.onUpdate];
+			if (actions.includes("set null") && meta.notNull) throw new SchemaBuildError(`Foreign key "${table.name}.${meta.columnName}" uses SET NULL but is not-null`);
+			if (actions.includes("set default") && !meta.hasDefault) throw new SchemaBuildError(`Foreign key "${table.name}.${meta.columnName}" uses SET DEFAULT without a local default`);
+			resolved.add(meta);
+		} finally {
+			resolving.delete(meta);
+		}
+	};
+	for (const table of tables.values()) for (const meta of Object.values(table.metas)) resolveForeignKey(table, meta);
+}
+
+//#endregion
+export { fk, resolveForeignKeys };
+//# sourceMappingURL=fk.js.map

package/dist/database/schema-builder/fk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fk.js","names":[],"sources":["../../../src/database/schema-builder/fk.ts"],"sourcesContent":["import { ColumnBuilder } from \"./columns\";\nimport {\n  type ColumnRef,\n  type FkRef,\n  type MutableColumnMeta,\n  SchemaBuildError,\n  type StorageKind,\n} from \"./types\";\n\n/** Declare foreign-key to another column. */\nexport function fk(ref: FkRef): ColumnBuilder {\n  const builder = new ColumnBuilder({ kind: \"fk\" }, \"number\");\n  builder._meta.fkRef = ref;\n  return builder;\n}\n\nexport function resolveFkRef(ref: FkRef): ColumnRef {\n  const resolved = typeof ref === \"function\" ? ref() : ref;\n  if (\n    !resolved ||\n    typeof resolved !== \"object\" ||\n    resolved.__isColumnRef !== true\n  ) {\n    throw new SchemaBuildError(\n      \"fk() must reference a column created by table()\",\n    );\n  }\n  return resolved;\n}\n\n/** A serial PK target stores as its plain integer type on the FK side. */\nexport function mirrorStorageKind(targetStorage: StorageKind): StorageKind {\n  if (targetStorage === \"id\") return \"integer\";\n  if (targetStorage === \"bigid\") return \"bigint\";\n  return targetStorage;\n}\n\ninterface ForeignKeyTable {\n  readonly name: string;\n  readonly metas: Readonly<Record<string, MutableColumnMeta>>;\n  readonly handle: Readonly<Record<string, ColumnRef>>;\n}\n\n/** Resolve FK identity, inherited storage, and action invariants in one pass. */\nexport function resolveForeignKeys(\n  tables: ReadonlyMap<string, ForeignKeyTable>,\n): void {\n  const references = new Map<\n    ColumnRef,\n    { readonly table: ForeignKeyTable; readonly meta: MutableColumnMeta }\n  >();\n  for (const table of tables.values()) {\n    for (const [columnName, reference] of Object.entries(table.handle)) {\n      const meta = table.metas[columnName];\n      if (!meta) {\n        throw new SchemaBuildError(\n          `Column reference \"${table.name}.${columnName}\" has no metadata`,\n        );\n      }\n      references.set(reference, { table, meta });\n    }\n  }\n\n  const resolving = new Set<MutableColumnMeta>();\n  const resolved = new Set<MutableColumnMeta>();\n\n  const resolveForeignKey = (\n    table: ForeignKeyTable,\n    meta: MutableColumnMeta,\n  ): void => {\n    if (!meta.fkRef || resolved.has(meta)) return;\n    if (resolving.has(meta)) {\n      throw new SchemaBuildError(\n        `Foreign key \"${table.name}.${meta.columnName}\" has a cyclic storage dependency`,\n      );\n    }\n\n    resolving.add(meta);\n    try {\n      const reference = resolveFkRef(meta.fkRef);\n      const targetIdentity = references.get(reference);\n      if (!targetIdentity) {\n        throw new SchemaBuildError(\n          `fk() on \"${table.name}.${meta.columnName}\" targets a column outside the returned schema`,\n        );\n      }\n\n      const { table: targetTable, meta: target } = targetIdentity;\n      resolveForeignKey(targetTable, target);\n      if (!target.primaryKey && !target.unique) {\n        throw new SchemaBuildError(\n          `fk() on \"${table.name}.${meta.columnName}\" must target a primary-key or unique column`,\n        );\n      }\n\n      meta.storageKind = mirrorStorageKind(target.storageKind);\n      meta.kind = target.kind;\n      meta.withTimezone = target.withTimezone;\n      meta.varcharLength = target.varcharLength;\n      meta.enumName = target.enumName;\n      meta.enumValues = target.enumValues\n        ? Object.freeze([...target.enumValues])\n        : undefined;\n      meta.fk = {\n        targetTable: targetTable.name,\n        targetColumn: target.columnName,\n        onDelete: meta.onDelete,\n        onUpdate: meta.onUpdate,\n      };\n\n      const actions = [meta.onDelete, meta.onUpdate];\n      if (actions.includes(\"set null\") && meta.notNull) {\n        throw new SchemaBuildError(\n          `Foreign key \"${table.name}.${meta.columnName}\" uses SET NULL but is not-null`,\n        );\n      }\n      if (actions.includes(\"set default\") && !meta.hasDefault) {\n        throw new SchemaBuildError(\n          `Foreign key \"${table.name}.${meta.columnName}\" uses SET DEFAULT without a local default`,\n        );\n      }\n      resolved.add(meta);\n    } finally {\n      resolving.delete(meta);\n    }\n  };\n\n  for (const table of tables.values()) {\n    for (const meta of Object.values(table.metas)) {\n      resolveForeignKey(table, meta);\n    }\n  }\n}\n"],"mappings":";;;;;AAUA,SAAgB,GAAG,KAA2B;CAC5C,MAAM,UAAU,IAAI,cAAc,EAAE,MAAM,MAAM,EAAE,SAAS;AAC3D,SAAQ,MAAM,QAAQ;AACtB,QAAO;;AAGT,SAAgB,aAAa,KAAuB;CAClD,MAAM,WAAW,OAAO,QAAQ,aAAa,KAAK,GAAG;AACrD,KACE,CAAC,YACD,OAAO,aAAa,YACpB,SAAS,kBAAkB,KAE3B,OAAM,IAAI,iBACR,kDACD;AAEH,QAAO;;;AAIT,SAAgB,kBAAkB,eAAyC;AACzE,KAAI,kBAAkB,KAAM,QAAO;AACnC,KAAI,kBAAkB,QAAS,QAAO;AACtC,QAAO;;;AAUT,SAAgB,mBACd,QACM;CACN,MAAM,6BAAa,IAAI,KAGpB;AACH,MAAK,MAAM,SAAS,OAAO,QAAQ,CACjC,MAAK,MAAM,CAAC,YAAY,cAAc,OAAO,QAAQ,MAAM,OAAO,EAAE;EAClE,MAAM,OAAO,MAAM,MAAM;AACzB,MAAI,CAAC,KACH,OAAM,IAAI,iBACR,qBAAqB,MAAM,KAAK,GAAG,WAAW,mBAC/C;AAEH,aAAW,IAAI,WAAW;GAAE;GAAO;GAAM,CAAC;;CAI9C,MAAM,4BAAY,IAAI,KAAwB;CAC9C,MAAM,2BAAW,IAAI,KAAwB;CAE7C,MAAM,qBACJ,OACA,SACS;AACT,MAAI,CAAC,KAAK,SAAS,SAAS,IAAI,KAAK,CAAE;AACvC,MAAI,UAAU,IAAI,KAAK,CACrB,OAAM,IAAI,iBACR,gBAAgB,MAAM,KAAK,GAAG,KAAK,WAAW,mCAC/C;AAGH,YAAU,IAAI,KAAK;AACnB,MAAI;GACF,MAAM,YAAY,aAAa,KAAK,MAAM;GAC1C,MAAM,iBAAiB,WAAW,IAAI,UAAU;AAChD,OAAI,CAAC,eACH,OAAM,IAAI,iBACR,YAAY,MAAM,KAAK,GAAG,KAAK,WAAW,gDAC3C;GAGH,MAAM,EAAE,OAAO,aAAa,MAAM,WAAW;AAC7C,qBAAkB,aAAa,OAAO;AACtC,OAAI,CAAC,OAAO,cAAc,CAAC,OAAO,OAChC,OAAM,IAAI,iBACR,YAAY,MAAM,KAAK,GAAG,KAAK,WAAW,8CAC3C;AAGH,QAAK,cAAc,kBAAkB,OAAO,YAAY;AACxD,QAAK,OAAO,OAAO;AACnB,QAAK,eAAe,OAAO;AAC3B,QAAK,gBAAgB,OAAO;AAC5B,QAAK,WAAW,OAAO;AACvB,QAAK,aAAa,OAAO,aACrB,OAAO,OAAO,CAAC,GAAG,OAAO,WAAW,CAAC,GACrC;AACJ,QAAK,KAAK;IACR,aAAa,YAAY;IACzB,cAAc,OAAO;IACrB,UAAU,KAAK;IACf,UAAU,KAAK;IAChB;GAED,MAAM,UAAU,CAAC,KAAK,UAAU,KAAK,SAAS;AAC9C,OAAI,QAAQ,SAAS,WAAW,IAAI,KAAK,QACvC,OAAM,IAAI,iBACR,gBAAgB,MAAM,KAAK,GAAG,KAAK,WAAW,iCAC/C;AAEH,OAAI,QAAQ,SAAS,cAAc,IAAI,CAAC,KAAK,WAC3C,OAAM,IAAI,iBACR,gBAAgB,MAAM,KAAK,GAAG,KAAK,WAAW,4CAC/C;AAEH,YAAS,IAAI,KAAK;YACV;AACR,aAAU,OAAO,KAAK;;;AAI1B,MAAK,MAAM,SAAS,OAAO,QAAQ,CACjC,MAAK,MAAM,QAAQ,OAAO,OAAO,MAAM,MAAM,CAC3C,mBAAkB,OAAO,KAAK"}

package/dist/database/schema-builder/index.js

@@ -0,0 +1,6 @@
+import { SchemaBuildError } from "./types.js";
+import { ColumnBuilder, bigid, bigint, boolean, enumColumn, id, integer, jsonb, text, timestamp, uuid, varchar } from "./columns.js";
+import { fk } from "./fk.js";
+import { defineSchema } from "./define-schema.js";
+
+export {  };

package/dist/database/schema-builder/relations.js

@@ -0,0 +1,51 @@
+import { SchemaBuildError } from "./types.js";
+
+//#region src/database/schema-builder/relations.ts
+/** @internal Build the canonical relation metadata before tables are published. */
+function buildRelations(tables) {
+	const result = /* @__PURE__ */ new Map();
+	for (const name of tables.keys()) result.set(name, []);
+	for (const table of tables.values()) {
+		const relations = result.get(table.name);
+		if (!relations) throw new SchemaBuildError("Relation table is not registered");
+		const columnNames = new Set(Object.keys(table.metas));
+		const seenTargets = /* @__PURE__ */ new Set();
+		for (const meta of Object.values(table.metas)) {
+			if (!meta.fk) continue;
+			const relationName = meta.fk.targetTable;
+			if (columnNames.has(relationName)) throw new SchemaBuildError(`Forward relation "${table.name}.${relationName}" collides with a column of the same name`);
+			if (seenTargets.has(relationName)) throw new SchemaBuildError(`Ambiguous forward relation "${table.name}.${relationName}": multiple foreign keys target "${relationName}"`);
+			seenTargets.add(relationName);
+			relations.push({
+				name: relationName,
+				cardinality: "toOne",
+				localColumn: meta.columnName,
+				targetTable: relationName,
+				targetColumn: meta.fk.targetColumn,
+				inferred: false
+			});
+		}
+	}
+	for (const table of tables.values()) for (const meta of Object.values(table.metas)) {
+		if (!meta.fk || meta.fk.targetTable === table.name) continue;
+		const target = tables.get(meta.fk.targetTable);
+		const targetRelations = result.get(meta.fk.targetTable);
+		if (!target || !targetRelations) throw new SchemaBuildError(`Relation target "${meta.fk.targetTable}" is not part of the schema`);
+		const relationName = table.name;
+		if (Object.hasOwn(target.metas, relationName)) throw new SchemaBuildError(`Reverse relation "${target.name}.${relationName}" collides with a column of the same name`);
+		if (targetRelations.some((relation) => relation.name === relationName)) throw new SchemaBuildError(`Reverse relation "${target.name}.${relationName}" is ambiguous`);
+		targetRelations.push({
+			name: relationName,
+			cardinality: "toMany",
+			localColumn: meta.fk.targetColumn,
+			targetTable: table.name,
+			targetColumn: meta.columnName,
+			inferred: true
+		});
+	}
+	return result;
+}
+
+//#endregion
+export { buildRelations };
+//# sourceMappingURL=relations.js.map

package/dist/database/schema-builder/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","names":[],"sources":["../../../src/database/schema-builder/relations.ts"],"sourcesContent":["import type { MutableColumnMeta, ResolvedRelation } from \"./types\";\nimport { SchemaBuildError } from \"./types\";\n\ninterface RelationSourceTable {\n  readonly name: string;\n  readonly metas: Readonly<Record<string, MutableColumnMeta>>;\n}\n\n/** @internal Build the canonical relation metadata before tables are published. */\nexport function buildRelations(\n  tables: ReadonlyMap<string, RelationSourceTable>,\n): Map<string, ResolvedRelation[]> {\n  const result = new Map<string, ResolvedRelation[]>();\n  for (const name of tables.keys()) result.set(name, []);\n\n  // Forward pass: each FK adds a to-one edge to its source table.\n  for (const table of tables.values()) {\n    const relations = result.get(table.name);\n    if (!relations)\n      throw new SchemaBuildError(\"Relation table is not registered\");\n    const columnNames = new Set(Object.keys(table.metas));\n    const seenTargets = new Set<string>();\n\n    for (const meta of Object.values(table.metas)) {\n      if (!meta.fk) continue;\n      const relationName = meta.fk.targetTable;\n      if (columnNames.has(relationName)) {\n        throw new SchemaBuildError(\n          `Forward relation \"${table.name}.${relationName}\" collides with a column of the same name`,\n        );\n      }\n      if (seenTargets.has(relationName)) {\n        throw new SchemaBuildError(\n          `Ambiguous forward relation \"${table.name}.${relationName}\": multiple foreign keys target \"${relationName}\"`,\n        );\n      }\n      seenTargets.add(relationName);\n      relations.push({\n        name: relationName,\n        cardinality: \"toOne\",\n        localColumn: meta.columnName,\n        targetTable: relationName,\n        targetColumn: meta.fk.targetColumn,\n        inferred: false,\n      });\n    }\n  }\n\n  // Reverse pass: each non-self FK adds a to-many edge to its target table.\n  for (const table of tables.values()) {\n    for (const meta of Object.values(table.metas)) {\n      if (!meta.fk || meta.fk.targetTable === table.name) continue;\n      const target = tables.get(meta.fk.targetTable);\n      const targetRelations = result.get(meta.fk.targetTable);\n      if (!target || !targetRelations) {\n        throw new SchemaBuildError(\n          `Relation target \"${meta.fk.targetTable}\" is not part of the schema`,\n        );\n      }\n\n      const relationName = table.name;\n      if (Object.hasOwn(target.metas, relationName)) {\n        throw new SchemaBuildError(\n          `Reverse relation \"${target.name}.${relationName}\" collides with a column of the same name`,\n        );\n      }\n      if (targetRelations.some((relation) => relation.name === relationName)) {\n        throw new SchemaBuildError(\n          `Reverse relation \"${target.name}.${relationName}\" is ambiguous`,\n        );\n      }\n      // Reverse edges deliberately retain their stable to-many result shape.\n      targetRelations.push({\n        name: relationName,\n        cardinality: \"toMany\",\n        localColumn: meta.fk.targetColumn,\n        targetTable: table.name,\n        targetColumn: meta.columnName,\n        inferred: true,\n      });\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;AASA,SAAgB,eACd,QACiC;CACjC,MAAM,yBAAS,IAAI,KAAiC;AACpD,MAAK,MAAM,QAAQ,OAAO,MAAM,CAAE,QAAO,IAAI,MAAM,EAAE,CAAC;AAGtD,MAAK,MAAM,SAAS,OAAO,QAAQ,EAAE;EACnC,MAAM,YAAY,OAAO,IAAI,MAAM,KAAK;AACxC,MAAI,CAAC,UACH,OAAM,IAAI,iBAAiB,mCAAmC;EAChE,MAAM,cAAc,IAAI,IAAI,OAAO,KAAK,MAAM,MAAM,CAAC;EACrD,MAAM,8BAAc,IAAI,KAAa;AAErC,OAAK,MAAM,QAAQ,OAAO,OAAO,MAAM,MAAM,EAAE;AAC7C,OAAI,CAAC,KAAK,GAAI;GACd,MAAM,eAAe,KAAK,GAAG;AAC7B,OAAI,YAAY,IAAI,aAAa,CAC/B,OAAM,IAAI,iBACR,qBAAqB,MAAM,KAAK,GAAG,aAAa,2CACjD;AAEH,OAAI,YAAY,IAAI,aAAa,CAC/B,OAAM,IAAI,iBACR,+BAA+B,MAAM,KAAK,GAAG,aAAa,mCAAmC,aAAa,GAC3G;AAEH,eAAY,IAAI,aAAa;AAC7B,aAAU,KAAK;IACb,MAAM;IACN,aAAa;IACb,aAAa,KAAK;IAClB,aAAa;IACb,cAAc,KAAK,GAAG;IACtB,UAAU;IACX,CAAC;;;AAKN,MAAK,MAAM,SAAS,OAAO,QAAQ,CACjC,MAAK,MAAM,QAAQ,OAAO,OAAO,MAAM,MAAM,EAAE;AAC7C,MAAI,CAAC,KAAK,MAAM,KAAK,GAAG,gBAAgB,MAAM,KAAM;EACpD,MAAM,SAAS,OAAO,IAAI,KAAK,GAAG,YAAY;EAC9C,MAAM,kBAAkB,OAAO,IAAI,KAAK,GAAG,YAAY;AACvD,MAAI,CAAC,UAAU,CAAC,gBACd,OAAM,IAAI,iBACR,oBAAoB,KAAK,GAAG,YAAY,6BACzC;EAGH,MAAM,eAAe,MAAM;AAC3B,MAAI,OAAO,OAAO,OAAO,OAAO,aAAa,CAC3C,OAAM,IAAI,iBACR,qBAAqB,OAAO,KAAK,GAAG,aAAa,2CAClD;AAEH,MAAI,gBAAgB,MAAM,aAAa,SAAS,SAAS,aAAa,CACpE,OAAM,IAAI,iBACR,qBAAqB,OAAO,KAAK,GAAG,aAAa,gBAClD;AAGH,kBAAgB,KAAK;GACnB,MAAM;GACN,aAAa;GACb,aAAa,KAAK,GAAG;GACrB,aAAa,MAAM;GACnB,cAAc,KAAK;GACnB,UAAU;GACX,CAAC;;AAIN,QAAO"}

package/dist/database/schema-builder/types.d.ts

@@ -0,0 +1,121 @@
+//#region src/database/schema-builder/types.d.ts
+declare const ENGINE_TABLE: unique symbol;
+declare const ENGINE_COLUMN: unique symbol;
+/** Opaque handles keep Drizzle types behind the schema/runtime boundary. */
+type EngineTable = {
+  readonly [ENGINE_TABLE]: true;
+};
+type EngineColumn = {
+  readonly [ENGINE_COLUMN]: true;
+};
+/** JavaScript value category exposed by a column, independent of its storage. */
+type ColumnValueKind = "string" | "number" | "bigint" | "boolean" | "date" | "json" | "uuid" | "enum" | "unknown";
+/** PostgreSQL action applied when a referenced row changes or is deleted. */
+type ReferentialAction = "cascade" | "set null" | "set default" | "restrict" | "no action";
+/** DSL declaration kind, including identity shorthand and unresolved FKs. */
+type ColumnTypeSpec = {
+  readonly kind: "id";
+} | {
+  readonly kind: "bigid";
+} | {
+  readonly kind: "text";
+} | {
+  readonly kind: "varchar";
+  readonly length: number;
+} | {
+  readonly kind: "integer";
+} | {
+  readonly kind: "bigint";
+} | {
+  readonly kind: "boolean";
+} | {
+  readonly kind: "uuid";
+} | {
+  readonly kind: "timestamp";
+  readonly withTimezone: boolean;
+} | {
+  readonly kind: "jsonb";
+} | {
+  readonly kind: "enum";
+  readonly enumName: string;
+  readonly values: readonly string[];
+} | {
+  readonly kind: "fk";
+};
+/** Resolved PostgreSQL storage used to construct the engine column. */
+type StorageKind = "id" | "bigid" | "text" | "varchar" | "integer" | "bigint" | "boolean" | "uuid" | "timestamp" | "jsonb" | "enum";
+interface ColumnRef {
+  readonly __isColumnRef: true;
+  readonly tableName: string;
+  readonly columnName: string;
+}
+type FkRef = ColumnRef | (() => ColumnRef);
+interface ResolvedForeignKey {
+  readonly targetTable: string;
+  readonly targetColumn: string;
+  readonly onDelete?: ReferentialAction;
+  readonly onUpdate?: ReferentialAction;
+}
+/** Mutable declaration state. It is cloned per table and never published. */
+interface MutableColumnMeta {
+  name: string;
+  columnName: string;
+  kind: ColumnValueKind;
+  storageKind: StorageKind;
+  notNull: boolean;
+  primaryKey: boolean;
+  unique: boolean;
+  isPrivate: boolean;
+  serverGenerated: boolean;
+  hasDefault: boolean;
+  defaultValue?: string | number | boolean;
+  defaultNow?: boolean;
+  defaultRandom?: boolean;
+  withTimezone?: boolean;
+  varcharLength?: number;
+  enumName?: string;
+  enumValues?: readonly string[];
+  fkRef?: FkRef;
+  onDelete?: ReferentialAction;
+  onUpdate?: ReferentialAction;
+  fk?: ResolvedForeignKey;
+  engineColumn?: EngineColumn;
+}
+/** Immutable column metadata published by a finalized schema. */
+type ColumnMeta = Readonly<Omit<MutableColumnMeta, "enumValues" | "fk" | "fkRef" | "engineColumn"> & {
+  readonly enumValues?: readonly string[];
+  readonly fk?: Readonly<ResolvedForeignKey>;
+  readonly engineColumn: EngineColumn;
+}>;
+interface ResolvedRelation {
+  readonly name: string;
+  readonly cardinality: "toOne" | "toMany";
+  readonly localColumn: string;
+  readonly targetTable: string;
+  readonly targetColumn: string;
+  readonly inferred: boolean;
+}
+interface AppKitTable {
+  readonly $name: string;
+  readonly $schemaName: string;
+  readonly $columns: Readonly<Record<string, ColumnMeta>>;
+  readonly $engine: EngineTable;
+  readonly $relations: readonly ResolvedRelation[];
+  /** @internal insert schema retained from the current-main foundation. */
+  readonly $insertSchema: unknown;
+  /** @internal update schema retained from the current-main foundation. */
+  readonly $updateSchema: unknown;
+}
+/** A declaration handle gains finalized table metadata only at publication. */
+type TableHandle<C extends Record<string, unknown>> = AppKitTable & { readonly [K in keyof C]: ColumnRef };
+interface DefineSchemaOptions {
+  readonly schemaName?: string;
+}
+interface Schema {
+  readonly $schemaName: string;
+  readonly $tables: Readonly<Record<string, AppKitTable>>;
+  readonly $engine: Readonly<Record<string, EngineTable>>;
+}
+//#endregion
+export { AppKitTable, ColumnTypeSpec, ColumnValueKind, DefineSchemaOptions, FkRef, MutableColumnMeta, ReferentialAction, Schema, TableHandle };
+//# sourceMappingURL=types.d.ts.map

package/dist/database/schema-builder/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/database/schema-builder/types.ts"],"mappings":";cAEc,YAAA;AAAA,cACA,aAAA;;KAEF,WAAA;EAAA,UAA0B,YAAA;AAAA;AAAA,KAC1B,YAAA;EAAA,UAA2B,aAAA;AAAA;;KAG3B,eAAA;;KAiCA,iBAAA;AApCZ;AAAA,KA4CY,cAAA;EAAA,SACG,IAAA;AAAA;EAAA,SACA,IAAA;AAAA;EAAA,SACA,IAAA;AAAA;EAAA,SACA,IAAA;EAAA,SAA0B,MAAA;AAAA;EAAA,SAC1B,IAAA;AAAA;EAAA,SACA,IAAA;AAAA;EAAA,SACA,IAAA;AAAA;EAAA,SACA,IAAA;AAAA;EAAA,SACA,IAAA;EAAA,SAA4B,YAAA;AAAA;EAAA,SAC5B,IAAA;AAAA;EAAA,SAEA,IAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;EAAA,SAEA,IAAA;AAAA;;KAGH,WAAA;AAAA,UAaK,SAAA;EAAA,SACN,aAAA;EAAA,SACA,SAAA;EAAA,SACA,UAAA;AAAA;AAAA,KAGC,KAAA,GAAQ,SAAA,UAAmB,SAAA;AAAA,UAEtB,kBAAA;EAAA,SACN,WAAA;EAAA,SACA,YAAA;EAAA,SACA,QAAA,GAAW,iBAAA;EAAA,SACX,QAAA,GAAW,iBAAA;AAAA;;UAIL,iBAAA;EACf,IAAA;EACA,UAAA;EACA,IAAA,EAAM,eAAA;EACN,WAAA,EAAa,WAAA;EACb,OAAA;EACA,UAAA;EACA,MAAA;EACA,SAAA;EACA,eAAA;EACA,UAAA;EACA,YAAA;EACA,UAAA;EACA,aAAA;EACA,YAAA;EACA,aAAA;EACA,QAAA;EACA,UAAA;EACA,KAAA,GAAQ,KAAA;EACR,QAAA,GAAW,iBAAA;EACX,QAAA,GAAW,iBAAA;EACX,EAAA,GAAK,kBAAA;EACL,YAAA,GAAe,YAAA;AAAA;;KAIL,UAAA,GAAa,QAAA,CACvB,IAAA,CAAK,iBAAA;EAAA,SACM,UAAA;EAAA,SACA,EAAA,GAAK,QAAA,CAAS,kBAAA;EAAA,SACd,YAAA,EAAc,YAAA;AAAA;AAAA,UAIV,gBAAA;EAAA,SACN,IAAA;EAAA,SACA,WAAA;EAAA,SACA,WAAA;EAAA,SACA,WAAA;EAAA,SACA,YAAA;EAAA,SACA,QAAA;AAAA;AAAA,UAGM,WAAA;EAAA,SACN,KAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA,EAAU,QAAA,CAAS,MAAA,SAAe,UAAA;EAAA,SAClC,OAAA,EAAS,WAAA;EAAA,SACT,UAAA,WAAqB,gBAAA;EAxC9B;EAAA,SA0CS,aAAA;EAxCT;EAAA,SA0CS,aAAA;AAAA;;KAIC,WAAA,WAAsB,MAAA,qBAA2B,WAAA,0BACtC,CAAA,GAAI,SAAA;AAAA,UAGV,mBAAA;EAAA,SACN,UAAA;AAAA;AAAA,UAGM,MAAA;EAAA,SACN,WAAA;EAAA,SACA,OAAA,EAAS,QAAA,CAAS,MAAA,SAAe,WAAA;EAAA,SACjC,OAAA,EAAS,QAAA,CAAS,MAAA,SAAe,WAAA;AAAA"}

package/dist/database/schema-builder/types.js

@@ -0,0 +1,43 @@
+//#region src/database/schema-builder/types.ts
+/** The filter subset shared by runtime translation and later typed surfaces. */
+function filterOperatorsForKind(kind) {
+	switch (kind) {
+		case "string": return [
+			"eq",
+			"neq",
+			"in",
+			"like",
+			"ilike"
+		];
+		case "number":
+		case "bigint":
+		case "date": return [
+			"eq",
+			"neq",
+			"in",
+			"gt",
+			"gte",
+			"lt",
+			"lte"
+		];
+		case "enum":
+		case "boolean":
+		case "uuid": return [
+			"eq",
+			"neq",
+			"in"
+		];
+		case "json":
+		case "unknown": return [];
+	}
+}
+var SchemaBuildError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "SchemaBuildError";
+	}
+};
+
+//#endregion
+export { SchemaBuildError, filterOperatorsForKind };
+//# sourceMappingURL=types.js.map

package/dist/database/schema-builder/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/database/schema-builder/types.ts"],"sourcesContent":["import type { FilterOperator } from \"../contract\";\n\ndeclare const ENGINE_TABLE: unique symbol;\ndeclare const ENGINE_COLUMN: unique symbol;\n/** Opaque handles keep Drizzle types behind the schema/runtime boundary. */\nexport type EngineTable = { readonly [ENGINE_TABLE]: true };\nexport type EngineColumn = { readonly [ENGINE_COLUMN]: true };\n\n/** JavaScript value category exposed by a column, independent of its storage. */\nexport type ColumnValueKind =\n  | \"string\"\n  | \"number\"\n  | \"bigint\"\n  | \"boolean\"\n  | \"date\"\n  | \"json\"\n  | \"uuid\"\n  | \"enum\"\n  | \"unknown\";\n\n/** The filter subset shared by runtime translation and later typed surfaces. */\nexport function filterOperatorsForKind(\n  kind: ColumnValueKind,\n): readonly FilterOperator[] {\n  switch (kind) {\n    case \"string\":\n      return [\"eq\", \"neq\", \"in\", \"like\", \"ilike\"];\n    case \"number\":\n    case \"bigint\":\n    case \"date\":\n      return [\"eq\", \"neq\", \"in\", \"gt\", \"gte\", \"lt\", \"lte\"];\n    case \"enum\":\n    case \"boolean\":\n    case \"uuid\":\n      return [\"eq\", \"neq\", \"in\"];\n    case \"json\":\n    case \"unknown\":\n      return [];\n  }\n}\n\n/** PostgreSQL action applied when a referenced row changes or is deleted. */\nexport type ReferentialAction =\n  | \"cascade\"\n  | \"set null\"\n  | \"set default\"\n  | \"restrict\"\n  | \"no action\";\n\n/** DSL declaration kind, including identity shorthand and unresolved FKs. */\nexport type ColumnTypeSpec =\n  | { readonly kind: \"id\" }\n  | { readonly kind: \"bigid\" }\n  | { readonly kind: \"text\" }\n  | { readonly kind: \"varchar\"; readonly length: number }\n  | { readonly kind: \"integer\" }\n  | { readonly kind: \"bigint\" }\n  | { readonly kind: \"boolean\" }\n  | { readonly kind: \"uuid\" }\n  | { readonly kind: \"timestamp\"; readonly withTimezone: boolean }\n  | { readonly kind: \"jsonb\" }\n  | {\n      readonly kind: \"enum\";\n      readonly enumName: string;\n      readonly values: readonly string[];\n    }\n  | { readonly kind: \"fk\" };\n\n/** Resolved PostgreSQL storage used to construct the engine column. */\nexport type StorageKind =\n  | \"id\"\n  | \"bigid\"\n  | \"text\"\n  | \"varchar\"\n  | \"integer\"\n  | \"bigint\"\n  | \"boolean\"\n  | \"uuid\"\n  | \"timestamp\"\n  | \"jsonb\"\n  | \"enum\";\n\nexport interface ColumnRef {\n  readonly __isColumnRef: true;\n  readonly tableName: string;\n  readonly columnName: string;\n}\n\nexport type FkRef = ColumnRef | (() => ColumnRef);\n\nexport interface ResolvedForeignKey {\n  readonly targetTable: string;\n  readonly targetColumn: string;\n  readonly onDelete?: ReferentialAction;\n  readonly onUpdate?: ReferentialAction;\n}\n\n/** Mutable declaration state. It is cloned per table and never published. */\nexport interface MutableColumnMeta {\n  name: string;\n  columnName: string;\n  kind: ColumnValueKind;\n  storageKind: StorageKind;\n  notNull: boolean;\n  primaryKey: boolean;\n  unique: boolean;\n  isPrivate: boolean;\n  serverGenerated: boolean;\n  hasDefault: boolean;\n  defaultValue?: string | number | boolean;\n  defaultNow?: boolean;\n  defaultRandom?: boolean;\n  withTimezone?: boolean;\n  varcharLength?: number;\n  enumName?: string;\n  enumValues?: readonly string[];\n  fkRef?: FkRef;\n  onDelete?: ReferentialAction;\n  onUpdate?: ReferentialAction;\n  fk?: ResolvedForeignKey;\n  engineColumn?: EngineColumn;\n}\n\n/** Immutable column metadata published by a finalized schema. */\nexport type ColumnMeta = Readonly<\n  Omit<MutableColumnMeta, \"enumValues\" | \"fk\" | \"fkRef\" | \"engineColumn\"> & {\n    readonly enumValues?: readonly string[];\n    readonly fk?: Readonly<ResolvedForeignKey>;\n    readonly engineColumn: EngineColumn;\n  }\n>;\n\nexport interface ResolvedRelation {\n  readonly name: string;\n  readonly cardinality: \"toOne\" | \"toMany\";\n  readonly localColumn: string;\n  readonly targetTable: string;\n  readonly targetColumn: string;\n  readonly inferred: boolean;\n}\n\nexport interface AppKitTable {\n  readonly $name: string;\n  readonly $schemaName: string;\n  readonly $columns: Readonly<Record<string, ColumnMeta>>;\n  readonly $engine: EngineTable;\n  readonly $relations: readonly ResolvedRelation[];\n  /** @internal insert schema retained from the current-main foundation. */\n  readonly $insertSchema: unknown;\n  /** @internal update schema retained from the current-main foundation. */\n  readonly $updateSchema: unknown;\n}\n\n/** A declaration handle gains finalized table metadata only at publication. */\nexport type TableHandle<C extends Record<string, unknown>> = AppKitTable & {\n  readonly [K in keyof C]: ColumnRef;\n};\n\nexport interface DefineSchemaOptions {\n  readonly schemaName?: string;\n}\n\nexport interface Schema {\n  readonly $schemaName: string;\n  readonly $tables: Readonly<Record<string, AppKitTable>>;\n  readonly $engine: Readonly<Record<string, EngineTable>>;\n}\n\nexport class SchemaBuildError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"SchemaBuildError\";\n  }\n}\n"],"mappings":";;AAqBA,SAAgB,uBACd,MAC2B;AAC3B,SAAQ,MAAR;EACE,KAAK,SACH,QAAO;GAAC;GAAM;GAAO;GAAM;GAAQ;GAAQ;EAC7C,KAAK;EACL,KAAK;EACL,KAAK,OACH,QAAO;GAAC;GAAM;GAAO;GAAM;GAAM;GAAO;GAAM;GAAM;EACtD,KAAK;EACL,KAAK;EACL,KAAK,OACH,QAAO;GAAC;GAAM;GAAO;GAAK;EAC5B,KAAK;EACL,KAAK,UACH,QAAO,EAAE;;;AAmIf,IAAa,mBAAb,cAAsC,MAAM;CAC1C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO"}

package/dist/database/schema-builder/validators.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+
+//#region src/database/schema-builder/validators.ts
+const PG_INTEGER_MIN = -2147483648;
+const PG_INTEGER_MAX = 2147483647;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Validate the canonical value shape accepted by the configured Drizzle column. */
+function columnValueSchema(meta) {
+	switch (meta.kind) {
+		case "string": {
+			const value = z.string();
+			return meta.storageKind === "varchar" ? value.max(meta.varcharLength ?? 255) : value;
+		}
+		case "number": return z.number().int().min(PG_INTEGER_MIN).max(PG_INTEGER_MAX);
+		case "bigint": return z.bigint();
+		case "boolean": return z.boolean();
+		case "date": return z.iso.datetime({
+			local: true,
+			offset: true
+		});
+		case "json": return z.json();
+		case "uuid": return z.string().regex(UUID_RE);
+		case "enum": return meta.enumValues && meta.enumValues.length > 0 ? z.enum([...meta.enumValues]) : z.never();
+		default: return z.never();
+	}
+}
+/** Trusted insert payload: private fields are allowed; identities are not. */
+function deriveInsertSchema(tables) {
+	const shape = {};
+	for (const meta of Object.values(tables.$columns)) {
+		if (meta.serverGenerated) continue;
+		let field = columnValueSchema(meta);
+		if (!meta.notNull) field = field.nullable();
+		if (!meta.notNull || meta.hasDefault) field = field.optional();
+		shape[meta.columnName] = field;
+	}
+	return z.strictObject(shape);
+}
+/** Trusted update payload: private fields are allowed; keys and identities are not. */
+function deriveUpdateSchema(tables) {
+	const shape = {};
+	for (const meta of Object.values(tables.$columns)) {
+		if (meta.serverGenerated || meta.primaryKey) continue;
+		let field = columnValueSchema(meta);
+		if (!meta.notNull) field = field.nullable();
+		shape[meta.columnName] = field.optional();
+	}
+	return z.strictObject(shape);
+}
+
+//#endregion
+export { columnValueSchema, deriveInsertSchema, deriveUpdateSchema };
+//# sourceMappingURL=validators.js.map

package/dist/database/schema-builder/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","names":[],"sources":["../../../src/database/schema-builder/validators.ts"],"sourcesContent":["import type { ZodType } from \"zod\";\nimport { z } from \"zod\";\n\nimport type { AppKitTable, ColumnMeta } from \"./types\";\n\nconst PG_INTEGER_MIN = -2_147_483_648;\nconst PG_INTEGER_MAX = 2_147_483_647;\nconst UUID_RE =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/** Validate the canonical value shape accepted by the configured Drizzle column. */\nexport function columnValueSchema(\n  meta: Pick<\n    ColumnMeta,\n    \"kind\" | \"storageKind\" | \"varcharLength\" | \"enumValues\"\n  >,\n): ZodType {\n  switch (meta.kind) {\n    case \"string\": {\n      const value = z.string();\n      return meta.storageKind === \"varchar\"\n        ? value.max(meta.varcharLength ?? 255)\n        : value;\n    }\n    case \"number\":\n      return z.number().int().min(PG_INTEGER_MIN).max(PG_INTEGER_MAX);\n    case \"bigint\":\n      return z.bigint();\n    case \"boolean\":\n      return z.boolean();\n    case \"date\":\n      return z.iso.datetime({ local: true, offset: true });\n    case \"json\":\n      return z.json();\n    case \"uuid\":\n      return z.string().regex(UUID_RE);\n    case \"enum\":\n      return meta.enumValues && meta.enumValues.length > 0\n        ? z.enum([...meta.enumValues] as [string, ...string[]])\n        : z.never();\n    default:\n      return z.never();\n  }\n}\n\n/** Trusted insert payload: private fields are allowed; identities are not. */\nexport function deriveInsertSchema(tables: AppKitTable): ZodType {\n  const shape: Record<string, ZodType> = {};\n\n  for (const meta of Object.values(tables.$columns)) {\n    if (meta.serverGenerated) continue;\n    let field = columnValueSchema(meta);\n\n    if (!meta.notNull) field = field.nullable();\n    if (!meta.notNull || meta.hasDefault) field = field.optional();\n    shape[meta.columnName] = field;\n  }\n\n  return z.strictObject(shape);\n}\n\n/** Trusted update payload: private fields are allowed; keys and identities are not. */\nexport function deriveUpdateSchema(tables: AppKitTable): ZodType {\n  const shape: Record<string, ZodType> = {};\n  for (const meta of Object.values(tables.$columns)) {\n    if (meta.serverGenerated || meta.primaryKey) continue;\n    let field = columnValueSchema(meta);\n    if (!meta.notNull) field = field.nullable();\n    shape[meta.columnName] = field.optional();\n  }\n  return z.strictObject(shape);\n}\n"],"mappings":";;;AAKA,MAAM,iBAAiB;AACvB,MAAM,iBAAiB;AACvB,MAAM,UACJ;;AAGF,SAAgB,kBACd,MAIS;AACT,SAAQ,KAAK,MAAb;EACE,KAAK,UAAU;GACb,MAAM,QAAQ,EAAE,QAAQ;AACxB,UAAO,KAAK,gBAAgB,YACxB,MAAM,IAAI,KAAK,iBAAiB,IAAI,GACpC;;EAEN,KAAK,SACH,QAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,IAAI,eAAe;EACjE,KAAK,SACH,QAAO,EAAE,QAAQ;EACnB,KAAK,UACH,QAAO,EAAE,SAAS;EACpB,KAAK,OACH,QAAO,EAAE,IAAI,SAAS;GAAE,OAAO;GAAM,QAAQ;GAAM,CAAC;EACtD,KAAK,OACH,QAAO,EAAE,MAAM;EACjB,KAAK,OACH,QAAO,EAAE,QAAQ,CAAC,MAAM,QAAQ;EAClC,KAAK,OACH,QAAO,KAAK,cAAc,KAAK,WAAW,SAAS,IAC/C,EAAE,KAAK,CAAC,GAAG,KAAK,WAAW,CAA0B,GACrD,EAAE,OAAO;EACf,QACE,QAAO,EAAE,OAAO;;;;AAKtB,SAAgB,mBAAmB,QAA8B;CAC/D,MAAM,QAAiC,EAAE;AAEzC,MAAK,MAAM,QAAQ,OAAO,OAAO,OAAO,SAAS,EAAE;AACjD,MAAI,KAAK,gBAAiB;EAC1B,IAAI,QAAQ,kBAAkB,KAAK;AAEnC,MAAI,CAAC,KAAK,QAAS,SAAQ,MAAM,UAAU;AAC3C,MAAI,CAAC,KAAK,WAAW,KAAK,WAAY,SAAQ,MAAM,UAAU;AAC9D,QAAM,KAAK,cAAc;;AAG3B,QAAO,EAAE,aAAa,MAAM;;;AAI9B,SAAgB,mBAAmB,QAA8B;CAC/D,MAAM,QAAiC,EAAE;AACzC,MAAK,MAAM,QAAQ,OAAO,OAAO,OAAO,SAAS,EAAE;AACjD,MAAI,KAAK,mBAAmB,KAAK,WAAY;EAC7C,IAAI,QAAQ,kBAAkB,KAAK;AACnC,MAAI,CAAC,KAAK,QAAS,SAAQ,MAAM,UAAU;AAC3C,QAAM,KAAK,cAAc,MAAM,UAAU;;AAE3C,QAAO,EAAE,aAAa,MAAM"}

package/dist/index.d.ts

@@ -7,18 +7,8 @@ import { ApiError } from "./shared/src/workspace-client/errors.js";
 import { createWorkspaceClient } from "./shared/src/workspace-client/factory.js";
 import "./shared/src/index.js";
 import { WorkspaceClient, WorkspaceClientOptions } from "./workspace-client/index.js";
-import { ExecutionResult } from "./plugin/execution-result.js";
+import { DatabaseRegistry } from "./database/contract/registry.js";
 import { CacheManager } from "./cache/index.js";
-import { ITelemetry, TelemetryConfig } from "./telemetry/types.js";
-import { Counter, Histogram, SeverityNumber, Span, SpanStatusCode } from "./telemetry/index.js";
-import { Plugin } from "./plugin/plugin.js";
-import { toPlugin } from "./plugin/to-plugin.js";
-import "./plugin/index.js";
-import { ResourcePermission, ResourceType } from "./registry/types.generated.js";
-import { ConfigSchema, PluginManifest, ResourceEntry, ResourceRequirement, ValidationResult } from "./registry/types.js";
-import { getPluginManifest, getResourceRequirements } from "./registry/manifest-loader.js";
-import { ResourceRegistry } from "./registry/resource-registry.js";
-import "./registry/index.js";
 import { JobsConnectorConfig } from "./connectors/jobs/types.js";
 import "./connectors/jobs/index.js";
 import { LakebasePoolManager, createLakebasePoolManager } from "./connectors/lakebase/pool-manager.js";
@@ -26,6 +16,8 @@ import { LakebasePool } from "./connectors/lakebase/routing-pool.js";
 import { DatabaseCredential, GenerateDatabaseCredentialRequest, LakebasePoolConfig, RequestedClaims, RequestedClaimsPermissionSet, RequestedResource, createLakebasePool, generateDatabaseCredential, getLakebaseOrmConfig, getLakebasePgConfig, getUsernameWithApiLookup, getWorkspaceClient } from "./connectors/lakebase/index.js";
 import { getExecutionContext } from "./context/execution-context.js";
 import "./context/index.js";
+import { ITelemetry, TelemetryConfig } from "./telemetry/types.js";
+import { Counter, Histogram, SeverityNumber, Span, SpanStatusCode } from "./telemetry/index.js";
 import { createApp } from "./core/appkit.js";
 import "./core/index.js";
 import { AppKitError } from "./errors/base.js";
@@ -37,8 +29,17 @@ import { InitializationError } from "./errors/initialization.js";
 import { ServerError } from "./errors/server.js";
 import { TunnelError } from "./errors/tunnel.js";
 import { ValidationError } from "./errors/validation.js";
+import { ExecutionResult } from "./plugin/execution-result.js";
+import { Plugin } from "./plugin/plugin.js";
+import { toPlugin } from "./plugin/to-plugin.js";
+import "./plugin/index.js";
 import { FileAction, FilePolicy, FilePolicyUser, FileResource, PolicyDeniedError, READ_ACTIONS, WRITE_ACTIONS } from "./plugins/files/policy.js";
 import { analytics } from "./plugins/analytics/analytics.js";
+import { ResourcePermission, ResourceType } from "./registry/types.generated.js";
+import { ConfigSchema, PluginManifest, ResourceEntry, ResourceRequirement, ValidationResult } from "./registry/types.js";
+import { defineManifest, getPluginManifest, getResourceRequirements } from "./registry/manifest-loader.js";
+import { ResourceRegistry } from "./registry/resource-registry.js";
+import "./registry/index.js";
 import { files } from "./plugins/files/plugin.js";
 import { genie } from "./plugins/genie/genie.js";
 import { IJobsConfig, JobAPI, JobConfig, JobsExport } from "./plugins/jobs/types.js";
@@ -52,4 +53,4 @@ import "./plugins/ga-exports.generated.js";
 import { extractServingEndpoints, findServerFile } from "./type-generator/serving/server-file-extractor.js";
 import { appKitServingTypesPlugin } from "./type-generator/serving/vite-plugin.js";
 import { appKitTypesPlugin } from "./type-generator/vite-plugin.js";
-export { ApiError, AppKitError, AuthenticationError, type BasePluginConfig, type CacheConfig, CacheManager, type ConfigSchema, ConfigurationError, ConnectionError, type Counter, type DatabaseCredential, type EndpointConfig, ExecutionError, type ExecutionResult, type FileAction, type FilePolicy, type FilePolicyUser, type FileResource, type GenerateDatabaseCredentialRequest, type Histogram, type IAppRouter, type IJobsConfig, type ITelemetry, InitializationError, type JobAPI, type JobConfig, type JobsConnectorConfig, type JobsExport, type LakebasePool, type LakebasePoolConfig, type LakebasePoolManager, Plugin, type PluginData, type PluginManifest, PolicyDeniedError, READ_ACTIONS, type RequestedClaims, RequestedClaimsPermissionSet, type RequestedResource, type ResourceEntry, type ResourceFieldEntry, type ResourcePermission, ResourceRegistry, type ResourceRequirement, ResourceType, ServerError, type ServingEndpointEntry, type ServingEndpointRegistry, type ServingFactory, SeverityNumber, type Span, SpanStatusCode, type StreamExecutionSettings, type TelemetryConfig, type ToPlugin, TunnelError, ValidationError, type ValidationResult, WRITE_ACTIONS, type WorkspaceClient, type WorkspaceClientOptions, analytics, appKitServingTypesPlugin, appKitTypesPlugin, createApp, createLakebasePool, createLakebasePoolManager, createWorkspaceClient, extractServingEndpoints, files, findServerFile, generateDatabaseCredential, genie, getExecutionContext, getLakebaseOrmConfig, getLakebasePgConfig, getPluginManifest, getResourceRequirements, getUsernameWithApiLookup, getWorkspaceClient, isSQLTypeMarker, jobs, lakebase, server, serving, sql, toPlugin };
+export { ApiError, AppKitError, AuthenticationError, type BasePluginConfig, type CacheConfig, CacheManager, type ConfigSchema, ConfigurationError, ConnectionError, type Counter, type DatabaseCredential, type DatabaseRegistry, type EndpointConfig, ExecutionError, type ExecutionResult, type FileAction, type FilePolicy, type FilePolicyUser, type FileResource, type GenerateDatabaseCredentialRequest, type Histogram, type IAppRouter, type IJobsConfig, type ITelemetry, InitializationError, type JobAPI, type JobConfig, type JobsConnectorConfig, type JobsExport, type LakebasePool, type LakebasePoolConfig, type LakebasePoolManager, Plugin, type PluginData, type PluginManifest, PolicyDeniedError, READ_ACTIONS, type RequestedClaims, RequestedClaimsPermissionSet, type RequestedResource, type ResourceEntry, type ResourceFieldEntry, type ResourcePermission, ResourceRegistry, type ResourceRequirement, ResourceType, ServerError, type ServingEndpointEntry, type ServingEndpointRegistry, type ServingFactory, SeverityNumber, type Span, SpanStatusCode, type StreamExecutionSettings, type TelemetryConfig, type ToPlugin, TunnelError, ValidationError, type ValidationResult, WRITE_ACTIONS, type WorkspaceClient, type WorkspaceClientOptions, analytics, appKitServingTypesPlugin, appKitTypesPlugin, createApp, createLakebasePool, createLakebasePoolManager, createWorkspaceClient, defineManifest, extractServingEndpoints, files, findServerFile, generateDatabaseCredential, genie, getExecutionContext, getLakebaseOrmConfig, getLakebasePgConfig, getPluginManifest, getResourceRequirements, getUsernameWithApiLookup, getWorkspaceClient, isSQLTypeMarker, jobs, lakebase, server, serving, sql, toPlugin };

package/dist/index.js

@@ -21,7 +21,7 @@ import { Plugin } from "./plugin/plugin.js";
 import { toPlugin } from "./plugin/to-plugin.js";
 import "./plugin/index.js";
 import { ResourceType } from "./registry/types.generated.js";
-import { getPluginManifest, getResourceRequirements } from "./registry/manifest-loader.js";
+import { defineManifest, getPluginManifest, getResourceRequirements } from "./registry/manifest-loader.js";
 import { ResourceRegistry } from "./registry/resource-registry.js";
 import "./registry/index.js";
 import { createApp } from "./core/appkit.js";
@@ -39,4 +39,4 @@ import { server } from "./plugins/server/index.js";
 import { serving } from "./plugins/serving/serving.js";
 import "./plugins/ga-exports.generated.js";
 
-export { ApiError, AppKitError, AuthenticationError, CacheManager, ConfigurationError, ConnectionError, ExecutionError, InitializationError, Plugin, PolicyDeniedError, READ_ACTIONS, RequestedClaimsPermissionSet, ResourceRegistry, ResourceType, ServerError, SeverityNumber, SpanStatusCode, TunnelError, ValidationError, WRITE_ACTIONS, analytics, appKitServingTypesPlugin, appKitTypesPlugin, createApp, createLakebasePool, createLakebasePoolManager, createWorkspaceClient, extractServingEndpoints, files, findServerFile, generateDatabaseCredential, genie, getExecutionContext, getLakebaseOrmConfig, getLakebasePgConfig, getPluginManifest, getResourceRequirements, getUsernameWithApiLookup, getWorkspaceClient, isSQLTypeMarker, jobs, lakebase, server, serving, sql, toPlugin };
+export { ApiError, AppKitError, AuthenticationError, CacheManager, ConfigurationError, ConnectionError, ExecutionError, InitializationError, Plugin, PolicyDeniedError, READ_ACTIONS, RequestedClaimsPermissionSet, ResourceRegistry, ResourceType, ServerError, SeverityNumber, SpanStatusCode, TunnelError, ValidationError, WRITE_ACTIONS, analytics, appKitServingTypesPlugin, appKitTypesPlugin, createApp, createLakebasePool, createLakebasePoolManager, createWorkspaceClient, defineManifest, extractServingEndpoints, files, findServerFile, generateDatabaseCredential, genie, getExecutionContext, getLakebaseOrmConfig, getLakebasePgConfig, getPluginManifest, getResourceRequirements, getUsernameWithApiLookup, getWorkspaceClient, isSQLTypeMarker, jobs, lakebase, server, serving, sql, toPlugin };

package/dist/plugin/plugin.d.ts

@@ -1,11 +1,11 @@
 import { BasePlugin, BasePluginConfig, IAppResponse, PluginEndpointMap, PluginPhase, RouteConfig } from "../shared/src/plugin.js";
 import { PluginExecutionSettings, StreamExecuteHandler, StreamExecutionSettings } from "../shared/src/execute.js";
 import "../shared/src/index.js";
-import { ExecutionResult } from "./execution-result.js";
-import { AppManager } from "../app/index.js";
 import { CacheManager } from "../cache/index.js";
 import { ITelemetry } from "../telemetry/types.js";
 import "../telemetry/index.js";
+import { ExecutionResult } from "./execution-result.js";
+import { AppManager } from "../app/index.js";
 import { PluginContext } from "../core/plugin-context.js";
 import { StreamManager } from "../stream/stream-manager.js";
 import "../stream/index.js";

package/dist/plugins/agents/agents.d.ts

@@ -5,11 +5,11 @@ import { AgentDefinition, AgentsPluginConfig, RegisteredAgent } from "../../core
 import { Plugin } from "../../plugin/plugin.js";
 import "../../plugin/index.js";
 import { PluginManifest } from "../../registry/types.js";
-import "../../registry/index.js";
+import "../../index.js";
 
 //#region src/plugins/agents/agents.d.ts
 declare class AgentsPlugin extends Plugin implements ToolProvider {
-  static manifest: PluginManifest;
+  static manifest: PluginManifest<"agents">;
   static phase: PluginPhase;
   protected config: AgentsPluginConfig;
   private agents;
@@ -264,7 +264,7 @@ declare class AgentsPlugin extends Plugin implements ToolProvider {
  * });
  * ```
  */
-declare const agents: ToPlugin<typeof AgentsPlugin, AgentsPluginConfig, string>;
+declare const agents: ToPlugin<typeof AgentsPlugin, AgentsPluginConfig, "agents">;
 //#endregion
 export { AgentsPlugin, agents };
 //# sourceMappingURL=agents.d.ts.map

package/dist/plugins/agents/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","names":[],"sources":["../../../src/plugins/agents/agents.ts"],"mappings":";;;;;;;;;;cAsJa,YAAA,SAAqB,MAAA,YAAkB,YAAA;EAAA,OAK3C,QAAA,EAAkC,cAAA;EAAA,OAClC,KAAA,EAAO,WAAA;EAAA,UAEI,MAAA,EAAQ,kBAAA;EAAA,QAElB,MAAA;EAAA,QACA,gBAAA;EAAA,QACA,aAAA;EAZgB;;;;;;EAAA,QAsBhB,gBAAA;EAAA,QACA,SAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;EAqzBa;EAAA,QAnzBb,0BAAA;EA+wDU;EAAA,QA7wDV,6BAAA;cAEI,MAAA,EAAQ,kBAAA;EAwxDE;;;;;;;;;;EAAA,QAzvDd,oBAAA;EAAA,YAKI,sBAAA,CAAA;EA7DL;EAAA,YAuFK,cAAA,CAAA;EArFM;EAAA,QAwGV,gBAAA;EAtGA;;;;;;EAAA,QAgHA,WAAA;EA/FA;;;;;EAAA,QAgHA,aAAA;EAYF,KAAA,CAAA,GAAK,OAAA;EA1DC;;;;;;EAyEN,MAAA,CAAA,GAAU,OAAA;EAAA;;;;;EAAA,QA0BF,kBAAA;EAsKA;;;;;EAAA,QAjEN,mBAAA;EAsPM;;;;EAAA,QAxNN,uBAAA;EAifR;;;;EAAA,QAleQ,0BAAA;EAAA,QAUA,iBAAA;EAkfa;;;;;;EAAA,QAxeP,cAAA;EAguBA;EAAA,QAnsBN,mBAAA;EAAA,QAeM,mBAAA;EA4rCA;;;;;;EAAA,QAzoCN,mBAAA;EAAA,QAmBM,oBAAA;EAAA,QAuBA,cAAA;EA2zCI;;;;;EAAA,QA/wCJ,cAAA;EAyxCmC;;;;;;;;;;;EAAA,QAzqCzC,eAAA;EAmrCM;;;AAwJhB;;;;;;;;;EAxJgB,QAvpCN,eAAA;EAAA,QAkBM,gBAAA;EAAA,QA0DA,kBAAA;EAiEd,aAAA,CAAA,GAAiB,mBAAA;EAIX,gBAAA,CAAA,GAAoB,OAAA;;;;;;;UAYlB,iBAAA;EAUR,YAAA,CAAa,MAAA,EAAQ,UAAA;EAkDrB,YAAA,CAAA,GAAgB,MAAA;EAAA,QAOF,WAAA;;;;;;;;;;;;UA6EN,gCAAA;;;;;;;;;;;UAuBM,aAAA;EAAA,QA2FA,YAAA;;;;;;;;;;;;;;;;;;;;;;;;UA2NA,qBAAA;;;;;;;;;;;;UA0KA,gBAAA;;;;;;;;;;;;;;;UAmIA,WAAA;EAAA,QAiGA,aAAA;EAAA,QA2BA,cAAA;EAAA,QAuCA,kBAAA;EAAA,QASA,gBAAA;EAAA,QAUA,mBAAA;EAAA,QAaN,YAAA;EAAA,QASA,aAAA;EAgBF,QAAA,CAAA,GAAY,OAAA;EAQlB,OAAA,CAAA;6BAE2B,GAAA,EAAO,eAAA,KAAe,OAAA;;2BAG3B,eAAA;;;oCAGS,OAAA,CAAA,MAAA;EAAA;EAAA,QAIjB,iBAAA;AAAA;;;;;;;;;;;;;;;;;;cAwJH,MAAA,EAAM,QAAA,QAAA,YAAA,EAAA,kBAAA"}
+{"version":3,"file":"agents.d.ts","names":[],"sources":["../../../src/plugins/agents/agents.ts"],"mappings":";;;;;;;;;;cAsJa,YAAA,SAAqB,MAAA,YAAkB,YAAA;EAAA,OAC3C,QAAA,EADiB,cAAA;EAAA,OAEjB,KAAA,EAAO,WAAA;EAAA,UAEI,MAAA,EAAQ,kBAAA;EAAA,QAElB,MAAA;EAAA,QACA,gBAAA;EAAA,QACA,aAAA;EARG;;;;;;EAAA,QAkBH,gBAAA;EAAA,QACA,SAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;EA+xBkB;EAAA,QA7xBlB,0BAAA;EAq2BQ;EAAA,QAn2BR,6BAAA;cAEI,MAAA,EAAQ,kBAAA;EAqxD6B;;;;;;;;;;EAAA,QAtvDzC,oBAAA;EAAA,YAKI,sBAAA,CAAA;EA9DG;EAAA,YAwFH,cAAA,CAAA;EAvFE;EAAA,QA0GN,gBAAA;EAxGkB;;;;;;EAAA,QAkHlB,WAAA;EAjGA;;;;;EAAA,QAkHA,aAAA;EAYF,KAAA,CAAA,GAAK,OAAA;EApFC;;;;;;EAmGN,MAAA,CAAA,GAAU,OAAA;EAAV;;;;;EAAA,QA0BQ,kBAAA;EA4JN;;;;;EAAA,QAvDA,mBAAA;EA0MM;;;;EAAA,QA5KN,uBAAA;EAgbM;;;;EAAA,QAjaN,0BAAA;EAAA,QAUA,iBAAA;EAkfR;;;;;;EAAA,QAxec,cAAA;EAqoBA;EAAA,QAxmBN,mBAAA;EAAA,QAeM,mBAAA;EAyjCA;;;;;;EAAA,QAtgCN,mBAAA;EAAA,QAmBM,oBAAA;EAAA,QAuBA,cAAA;EA2zCR;;;;;EAAA,QA/wCQ,cAAA;EAyxCa;;;;;;;;;;;EAAA,QAzqCnB,eAAA;EA+qCuB;;;;AA4JjC;;;;;;;;EA5JiC,QAnpCvB,eAAA;EAAA,QAkBM,gBAAA;EAAA,QA0DA,kBAAA;EAiEd,aAAA,CAAA,GAAiB,mBAAA;EAIX,gBAAA,CAAA,GAAoB,OAAA;;;;;;;UAYlB,iBAAA;EAUR,YAAA,CAAa,MAAA,EAAQ,UAAA;EAkDrB,YAAA,CAAA,GAAgB,MAAA;EAAA,QAOF,WAAA;;;;;;;;;;;;UA6EN,gCAAA;;;;;;;;;;;UAuBM,aAAA;EAAA,QA2FA,YAAA;;;;;;;;;;;;;;;;;;;;;;;;UA2NA,qBAAA;;;;;;;;;;;;UA0KA,gBAAA;;;;;;;;;;;;;;;UAmIA,WAAA;EAAA,QAiGA,aAAA;EAAA,QA2BA,cAAA;EAAA,QAuCA,kBAAA;EAAA,QASA,gBAAA;EAAA,QAUA,mBAAA;EAAA,QAaN,YAAA;EAAA,QASA,aAAA;EAgBF,QAAA,CAAA,GAAY,OAAA;EAQlB,OAAA,CAAA;6BAE2B,GAAA,EAAO,eAAA,KAAe,OAAA;;2BAG3B,eAAA;;;oCAGS,OAAA,CAAA,MAAA;EAAA;EAAA,QAIjB,iBAAA;AAAA;;;;;;;;;;;;;;;;;;cAwJH,MAAA,EAAM,QAAA,QAAA,YAAA,EAAA,kBAAA"}

package/dist/plugins/agents/agents.js

@@ -2,6 +2,8 @@ import { createLogger } from "../../logging/logger.js";
 import { Plugin } from "../../plugin/plugin.js";
 import { toPlugin } from "../../plugin/to-plugin.js";
 import "../../plugin/index.js";
+import { defineManifest } from "../../registry/manifest-loader.js";
+import "../../registry/index.js";
 import { buildMcpHostPolicy } from "../../connectors/mcp/host-policy.js";
 import { AppKitMcpClient } from "../../connectors/mcp/client.js";
 import "../../connectors/mcp/index.js";
@@ -58,7 +60,7 @@ function requiresApproval(annotations) {
 	}
 }
 var AgentsPlugin = class extends Plugin {
-	static manifest = manifest_default;
+	static manifest = defineManifest(manifest_default);
 	static phase = "deferred";
 	agents = /* @__PURE__ */ new Map();
 	defaultAgentName = null;