@haustle/notion-orm 0.0.44 → 0.0.45

package/build/src/ast/demo/demo-workspace-builder.d.ts

@@ -0,0 +1,24 @@
+import { type DemoPlaygroundSpec } from "./demo-playground-spec";
+export interface DemoPlaygroundWorkspaceResult {
+    files: Record<string, string>;
+    databaseEntryFile: string;
+    agentEntryFile: string;
+}
+/**
+ * Pure builder that produces the full demo playground virtual workspace.
+ *
+ * Accepts the demo spec and pre-read mock source file contents, then
+ * composes the existing ORM emitters (database, agent, index) with
+ * demo entry builders and static support files to produce the complete
+ * file map consumed by the browser-based TypeScript environment.
+ *
+ * No filesystem I/O — callers provide inputs and serialize the result.
+ */
+export declare function buildDemoPlaygroundWorkspace(args: {
+    spec?: DemoPlaygroundSpec;
+    mockPackageSource: string;
+    mockBaseSource: string;
+    /** Same source as repo `src/notion-id-patterns.ts` (playground mock imports it). */
+    notionIdPatternsSource: string;
+}): DemoPlaygroundWorkspaceResult;
+//# sourceMappingURL=demo-workspace-builder.d.ts.map

package/build/src/ast/demo/demo-workspace-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-workspace-builder.d.ts","sourceRoot":"","sources":["../../../../src/ast/demo/demo-workspace-builder.ts"],"names":[],"mappings":"AAaA,OAAO,EAEN,KAAK,kBAAkB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,6BAA6B;IAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACvB;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAClD,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,sBAAsB,EAAE,MAAM,CAAC;CAC/B,GAAG,6BAA6B,CA+EhC"}

package/build/src/ast/demo/demo-workspace-builder.js

@@ -0,0 +1,90 @@
+import { buildMockDataSourceResponse } from "./datasource-fixture-builder.js";
+import { renderAgentModule } from "../agents/agent-file-writer.js";
+import { renderDatabaseModule } from "../database/database-file-writer.js";
+import { AST_RUNTIME_CONSTANTS, PLAYGROUND_PATHS } from "../shared/constants.js";
+import { buildOrmIndexModuleAst, } from "../shared/emit/orm-index-emitter.js";
+import { createEmitContext, printTsNodes } from "../shared/emit/ts-emit-core.js";
+import { buildDemoAgentEntry, buildDemoDatabaseEntry, } from "./demo-entry-builders.js";
+import { DEMO_PLAYGROUND_SPEC, } from "./demo-playground-spec.js";
+const PLAYGROUND_TSCONFIG = JSON.stringify({
+    compilerOptions: {
+        target: "ES2022",
+        module: "ESNext",
+        moduleResolution: "bundler",
+        allowImportingTsExtensions: true,
+        noEmit: true,
+        strict: true,
+        esModuleInterop: true,
+    },
+}, null, 2);
+/**
+ * Pure builder that produces the full demo playground virtual workspace.
+ *
+ * Accepts the demo spec and pre-read mock source file contents, then
+ * composes the existing ORM emitters (database, agent, index) with
+ * demo entry builders and static support files to produce the complete
+ * file map consumed by the browser-based TypeScript environment.
+ *
+ * No filesystem I/O — callers provide inputs and serialize the result.
+ */
+export function buildDemoPlaygroundWorkspace(args) {
+    const { spec = DEMO_PLAYGROUND_SPEC, mockPackageSource, mockBaseSource, notionIdPatternsSource, } = args;
+    const databaseModules = spec.databases.map((fixture) => renderDatabaseModule(buildMockDataSourceResponse(fixture)));
+    const agentModules = spec.agents.map((agent) => renderAgentModule({
+        agentId: agent.id,
+        agentName: agent.name,
+        agentIcon: agent.icon,
+    }));
+    const databaseMetadata = databaseModules.map((database) => ({ name: database.databaseModuleName }));
+    const agentMetadata = agentModules.map((agent) => ({
+        name: agent.agentModuleName,
+    }));
+    const generatedIndexTs = printTsNodes({
+        nodes: buildOrmIndexModuleAst({
+            databases: databaseMetadata,
+            agents: agentMetadata,
+            syncCommand: AST_RUNTIME_CONSTANTS.CLI_GENERATE_COMMAND,
+            importPaths: {
+                databaseClass: PLAYGROUND_PATHS.databaseImport,
+                agentClass: PLAYGROUND_PATHS.agentImport,
+            },
+        }),
+        context: createEmitContext({ fileName: "index.ts" }),
+    });
+    const databaseEntry = buildDemoDatabaseEntry({
+        spec,
+        databaseModules: databaseModules.map((m) => ({
+            moduleName: m.databaseModuleName,
+            databaseTitle: m.databaseName,
+        })),
+    });
+    const agentEntry = buildDemoAgentEntry({
+        spec,
+        agentModules: agentModules.map((m) => ({
+            moduleName: m.agentModuleName,
+            agentName: m.agentName,
+        })),
+    });
+    const files = {
+        [spec.databaseEntryFile]: databaseEntry,
+        [spec.agentEntryFile]: agentEntry,
+        [PLAYGROUND_PATHS.BUILD_INDEX]: generatedIndexTs,
+        [PLAYGROUND_PATHS.MOCK_PACKAGE_INDEX]: mockPackageSource,
+        [PLAYGROUND_PATHS.MOCK_PACKAGE_NOTION_ID_PATTERNS]: notionIdPatternsSource,
+        [PLAYGROUND_PATHS.MOCK_PACKAGE_BASE]: mockBaseSource,
+    };
+    for (const database of databaseModules) {
+        files[PLAYGROUND_PATHS.databaseModule(database.databaseModuleName)] =
+            database.tsCode;
+    }
+    for (const agent of agentModules) {
+        files[PLAYGROUND_PATHS.agentModule(agent.agentModuleName)] = agent.tsCode;
+    }
+    files["tsconfig.json"] = PLAYGROUND_TSCONFIG;
+    return {
+        files,
+        databaseEntryFile: spec.databaseEntryFile,
+        agentEntryFile: spec.agentEntryFile,
+    };
+}
+//# sourceMappingURL=demo-workspace-builder.js.map

package/build/src/ast/demo/demo-workspace-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-workspace-builder.js","sourceRoot":"","sources":["../../../../src/ast/demo/demo-workspace-builder.ts"],"names":[],"mappings":"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"}

package/build/src/ast/shared/ast-builders.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Reusable AST builder functions for generating TypeScript code.
+ * These functions create TypeScript AST nodes for properties, imports, exports, and types.
+ */
+import * as ts from "typescript";
+import type { ColumnTypesWithOptions, SupportedNotionColumnType } from "../../client/database/types";
+import type { NotionDatabaseId } from "../../client/database/types/notion-database-id";
+export { toPascalCase } from "../../helpers";
+/**
+ * Plain column: emitted metadata has no `options` array (non–select-like types).
+ */
+export type OptionlessColumnMetadataEntry = {
+    readonly columnName: string;
+    readonly type: Exclude<SupportedNotionColumnType, ColumnTypesWithOptions | "relation">;
+};
+/**
+ * Relation: emitted metadata includes the linked database id (undashed) from Notion.
+ */
+export type RelationGeneratedColumnMetadataEntry = {
+    readonly columnName: string;
+    readonly type: "relation";
+    readonly relatedDatabaseId: NotionDatabaseId;
+};
+/**
+ * Select / status / multi_select: emitted metadata includes `options` pointing at a
+ * generated const; `type` discriminates this arm from {@link OptionlessColumnMetadataEntry}.
+ */
+export type SelectLikeGeneratedColumnMetadataEntry = {
+    readonly columnName: string;
+    readonly type: ColumnTypesWithOptions;
+    readonly optionsIdentifier: string;
+};
+export type GeneratedColumnMetadataEntry = OptionlessColumnMetadataEntry | SelectLikeGeneratedColumnMetadataEntry | RelationGeneratedColumnMetadataEntry;
+/** Lookup map used to generate the emitted `columns` object. */
+export type GeneratedColumnMetadataMap = Record<string, GeneratedColumnMetadataEntry>;
+/**
+ * Generate text property signature
+ * name: string (or name?: string if not title)
+ */
+export declare function createTextProperty(args: {
+    name: string;
+    isTitle: boolean;
+}): ts.PropertySignature;
+/**
+ * Generate number property signature
+ * name?: number
+ */
+export declare function createNumberProperty(name: string): ts.PropertySignature;
+/**
+ * Generate date property signature
+ * name?: { start: string; end?: string }
+ */
+export declare function createDateProperty(name: string): ts.PropertySignature;
+/**
+ * Generate checkbox property signature
+ * name?: boolean
+ */
+export declare function createCheckboxProperty(name: string): ts.PropertySignature;
+/**
+ * For selects and multi-select collection properties
+ * array = true for multi-select
+ */
+export declare function createMultiOptionProp(args: {
+    name: string;
+    arrayIdentifier: string;
+    isArray: boolean;
+}): ts.PropertySignature;
+/**
+ * Create a const array of property values for enum types
+ */
+export declare function createPropertyValuesArray(args: {
+    identifier: string;
+    options: string[];
+}): ts.VariableStatement;
+/**
+ * Create import declaration
+ */
+export declare function createNameImport(args: {
+    namedImport: string;
+    path: string;
+    typeOnly?: boolean;
+}): ts.ImportDeclaration;
+/**
+ * `import type { a, b } from "path"`
+ */
+export declare function createTypeOnlyNamedImports(args: {
+    names: readonly string[];
+    path: string;
+}): ts.ImportDeclaration;
+/**
+ * Create column name to column properties mapping
+ * Maps camelCase property names to their original names and types
+ */
+export declare function createColumnNameToColumnProperties(colMap: GeneratedColumnMetadataMap): ts.VariableDeclarationList;
+/** `export type QuerySchema = Query<DatabaseDefinition<typeof columns>>` (name from `AST_TYPE_NAMES.QUERY_SCHEMA`). */
+export declare function createQuerySchemaTypeExport(): ts.TypeAliasDeclaration;
+/** `export type PageSchema = InferDatabaseSchema<typeof columns>` (name from `AST_TYPE_NAMES.PAGE_SCHEMA`). */
+export declare function createPageSchemaTypeExport(): ts.TypeAliasDeclaration;
+/** `export type CreateSchema = InferCreateSchema<typeof columns>` (name from `AST_TYPE_NAMES.CREATE_SCHEMA`). */
+export declare function createCreateSchemaTypeExport(): ts.TypeAliasDeclaration;
+/**
+ * Create export statement for the database constructor function.
+ * Uses a block body + multiline object literal so generated files stay readable.
+ * `databaseName` is the exported const identifier (PascalCase, e.g. `CustomerOrders`).
+ */
+export declare function createDatabaseClassExport(args: {
+    databaseName: string;
+    schemaTitle: string;
+    /** Undashed Notion data source id, inlined on the client config object. */
+    databaseId: string;
+}): ts.VariableStatement;
+//# sourceMappingURL=ast-builders.d.ts.map

package/build/src/ast/shared/ast-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-builders.d.ts","sourceRoot":"","sources":["../../../../src/ast/shared/ast-builders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EACX,sBAAsB,EACtB,yBAAyB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAIvF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,yBAAyB,EAAE,sBAAsB,GAAG,UAAU,CAAC,CAAC;CACvF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACrC,6BAA6B,GAC7B,sCAAsC,GACtC,oCAAoC,CAAC;AAExC,gEAAgE;AAChE,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAC9C,MAAM,EACN,4BAA4B,CAC5B,CAAC;AAoCF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,wBAS1E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,wBAQhD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,wBAoB9C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,wBAQlD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,wBAgBA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,wBAyBA;AAyBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,wBAkBA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAChD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACb,GAAG,EAAE,CAAC,iBAAiB,CAmBvB;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,0BAA0B,8BAoDnC;AAED,uHAAuH;AACvH,wBAAgB,2BAA2B,4BAS1C;AAED,+GAA+G;AAC/G,wBAAgB,0BAA0B,4BAezC;AAED,iHAAiH;AACjH,wBAAgB,4BAA4B,4BAe3C;AAcD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;CACpB,wBA+DA"}

package/build/src/ast/shared/ast-builders.js

@@ -0,0 +1,181 @@
+/**
+ * Reusable AST builder functions for generating TypeScript code.
+ * These functions create TypeScript AST nodes for properties, imports, exports, and types.
+ */
+import * as ts from "typescript";
+import { objectEntries } from "../../typeUtils.js";
+import { AST_TYPE_NAMES } from "./constants.js";
+export { toPascalCase } from "../../helpers.js";
+function optionsPropertyAssignmentsForSelectLikeMetadata(entry) {
+    return [
+        ts.factory.createPropertyAssignment(ts.factory.createIdentifier("options"), ts.factory.createIdentifier(entry.optionsIdentifier)),
+    ];
+}
+/** Emits `options` / `relatedDatabaseId` for column metadata beyond `columnName` + `type`. */
+function extraMetadataPropertyAssignmentsForGeneratedColumn(value) {
+    switch (value.type) {
+        case "select":
+        case "status":
+        case "multi_select":
+            return optionsPropertyAssignmentsForSelectLikeMetadata(value);
+        case "relation":
+            return [
+                ts.factory.createPropertyAssignment(ts.factory.createIdentifier("relatedDatabaseId"), ts.factory.createStringLiteral(String(value.relatedDatabaseId))),
+            ];
+        default:
+            return [];
+    }
+}
+/**
+ * Generate text property signature
+ * name: string (or name?: string if not title)
+ */
+export function createTextProperty(args) {
+    const { name, isTitle } = args;
+    const text = ts.factory.createPropertySignature(undefined, ts.factory.createIdentifier(name), !isTitle ? ts.factory.createToken(ts.SyntaxKind.QuestionToken) : undefined, ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword));
+    return text;
+}
+/**
+ * Generate number property signature
+ * name?: number
+ */
+export function createNumberProperty(name) {
+    const number = ts.factory.createPropertySignature(undefined, ts.factory.createIdentifier(name), ts.factory.createToken(ts.SyntaxKind.QuestionToken), ts.factory.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword));
+    return number;
+}
+/**
+ * Generate date property signature
+ * name?: { start: string; end?: string }
+ */
+export function createDateProperty(name) {
+    return ts.factory.createPropertySignature(undefined, ts.factory.createIdentifier(name), ts.factory.createToken(ts.SyntaxKind.QuestionToken), ts.factory.createTypeLiteralNode([
+        ts.factory.createPropertySignature(undefined, ts.factory.createIdentifier("start"), undefined, ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword)),
+        ts.factory.createPropertySignature(undefined, ts.factory.createIdentifier("end"), ts.factory.createToken(ts.SyntaxKind.QuestionToken), ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword)),
+    ]));
+}
+/**
+ * Generate checkbox property signature
+ * name?: boolean
+ */
+export function createCheckboxProperty(name) {
+    const checkbox = ts.factory.createPropertySignature(undefined, ts.factory.createIdentifier(name), ts.factory.createToken(ts.SyntaxKind.QuestionToken), ts.factory.createKeywordTypeNode(ts.SyntaxKind.BooleanKeyword));
+    return checkbox;
+}
+/**
+ * For selects and multi-select collection properties
+ * array = true for multi-select
+ */
+export function createMultiOptionProp(args) {
+    const { arrayIdentifier, isArray, name } = args;
+    const propertyValueUnion = ts.factory.createUnionTypeNode([
+        createPropertyValuesElementType(arrayIdentifier),
+        createOtherStringProp(),
+    ]);
+    return ts.factory.createPropertySignature(undefined, ts.factory.createIdentifier(name), ts.factory.createToken(ts.SyntaxKind.QuestionToken), isArray
+        ? ts.factory.createArrayTypeNode(ts.factory.createParenthesizedType(propertyValueUnion))
+        : propertyValueUnion);
+}
+/**
+ * Create a const array of property values for enum types
+ */
+export function createPropertyValuesArray(args) {
+    const { identifier, options } = args;
+    return ts.factory.createVariableStatement([ts.factory.createToken(ts.SyntaxKind.ExportKeyword)], ts.factory.createVariableDeclarationList([
+        ts.factory.createVariableDeclaration(ts.factory.createIdentifier(identifier), undefined, undefined, ts.factory.createAsExpression(ts.factory.createArrayLiteralExpression(options.map((option) => ts.factory.createStringLiteral(option)), true), ts.factory.createTypeReferenceNode(ts.factory.createIdentifier("const"), undefined))),
+    ], ts.NodeFlags.Const));
+}
+/**
+ * string & {} - Allows users to pass in custom values
+ */
+function createOtherStringProp() {
+    return ts.factory.createIntersectionTypeNode([
+        ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
+        ts.factory.createTypeLiteralNode([]),
+    ]);
+}
+/**
+ * Builds `<PropertyValuesConst>[number]` element type reference.
+ */
+function createPropertyValuesElementType(arrayIdentifier) {
+    return ts.factory.createIndexedAccessTypeNode(ts.factory.createTypeQueryNode(ts.factory.createIdentifier(arrayIdentifier), undefined), ts.factory.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword));
+}
+/**
+ * Create import declaration
+ */
+export function createNameImport(args) {
+    const { namedImport, path, typeOnly } = args;
+    return ts.factory.createImportDeclaration(undefined, ts.factory.createImportClause(typeOnly ?? false, undefined, ts.factory.createNamedImports([
+        ts.factory.createImportSpecifier(false, undefined, ts.factory.createIdentifier(namedImport)),
+    ])), ts.factory.createStringLiteral(path), undefined);
+}
+/**
+ * `import type { a, b } from "path"`
+ */
+export function createTypeOnlyNamedImports(args) {
+    return ts.factory.createImportDeclaration(undefined, ts.factory.createImportClause(true, undefined, ts.factory.createNamedImports(args.names.map((name) => ts.factory.createImportSpecifier(false, undefined, ts.factory.createIdentifier(name))))), ts.factory.createStringLiteral(args.path), undefined);
+}
+/**
+ * Create column name to column properties mapping
+ * Maps camelCase property names to their original names and types
+ */
+export function createColumnNameToColumnProperties(colMap) {
+    const metadataObjectLiteral = ts.factory.createObjectLiteralExpression([
+        ...objectEntries(colMap).map(([propName, value]) => ts.factory.createPropertyAssignment(ts.factory.createStringLiteral(propName), ts.factory.createObjectLiteralExpression([
+            ts.factory.createPropertyAssignment(ts.factory.createIdentifier("columnName"), ts.factory.createStringLiteral(value.columnName)),
+            ts.factory.createPropertyAssignment(ts.factory.createIdentifier("type"), ts.factory.createStringLiteral(value.type)),
+            ...extraMetadataPropertyAssignmentsForGeneratedColumn(value),
+        ], true))),
+    ], true);
+    const asConst = ts.factory.createAsExpression(metadataObjectLiteral, ts.factory.createTypeReferenceNode(ts.factory.createIdentifier("const"), undefined));
+    const satisfiesTarget = ts.factory.createTypeReferenceNode(ts.factory.createIdentifier("DatabaseColumns"), undefined);
+    const initializer = ts.factory.createSatisfiesExpression(asConst, satisfiesTarget);
+    return ts.factory.createVariableDeclarationList([
+        ts.factory.createVariableDeclaration(ts.factory.createIdentifier("columns"), undefined, undefined, initializer),
+    ], ts.NodeFlags.Const);
+}
+/** `export type QuerySchema = Query<DatabaseDefinition<typeof columns>>` (name from `AST_TYPE_NAMES.QUERY_SCHEMA`). */
+export function createQuerySchemaTypeExport() {
+    return ts.factory.createTypeAliasDeclaration([ts.factory.createToken(ts.SyntaxKind.ExportKeyword)], ts.factory.createIdentifier(AST_TYPE_NAMES.QUERY_SCHEMA), undefined, ts.factory.createTypeReferenceNode(ts.factory.createIdentifier("Query"), [
+        createDatabaseDefinitionOfColumnsTypeReference(),
+    ]));
+}
+/** `export type PageSchema = InferDatabaseSchema<typeof columns>` (name from `AST_TYPE_NAMES.PAGE_SCHEMA`). */
+export function createPageSchemaTypeExport() {
+    return ts.factory.createTypeAliasDeclaration([ts.factory.createToken(ts.SyntaxKind.ExportKeyword)], ts.factory.createIdentifier(AST_TYPE_NAMES.PAGE_SCHEMA), undefined, ts.factory.createTypeReferenceNode(ts.factory.createIdentifier("InferDatabaseSchema"), [
+        ts.factory.createTypeQueryNode(ts.factory.createIdentifier("columns"), undefined),
+    ]));
+}
+/** `export type CreateSchema = InferCreateSchema<typeof columns>` (name from `AST_TYPE_NAMES.CREATE_SCHEMA`). */
+export function createCreateSchemaTypeExport() {
+    return ts.factory.createTypeAliasDeclaration([ts.factory.createToken(ts.SyntaxKind.ExportKeyword)], ts.factory.createIdentifier(AST_TYPE_NAMES.CREATE_SCHEMA), undefined, ts.factory.createTypeReferenceNode(ts.factory.createIdentifier("InferCreateSchema"), [
+        ts.factory.createTypeQueryNode(ts.factory.createIdentifier("columns"), undefined),
+    ]));
+}
+function createDatabaseDefinitionOfColumnsTypeReference() {
+    return ts.factory.createTypeReferenceNode(ts.factory.createIdentifier("DatabaseDefinition"), [
+        ts.factory.createTypeQueryNode(ts.factory.createIdentifier("columns"), undefined),
+    ]);
+}
+/**
+ * Create export statement for the database constructor function.
+ * Uses a block body + multiline object literal so generated files stay readable.
+ * `databaseName` is the exported const identifier (PascalCase, e.g. `CustomerOrders`).
+ */
+export function createDatabaseClassExport(args) {
+    const { databaseName, schemaTitle, databaseId } = args;
+    const clientConfigObject = ts.factory.createObjectLiteralExpression([
+        ts.factory.createPropertyAssignment(ts.factory.createIdentifier("id"), ts.factory.createStringLiteral(databaseId)),
+        ts.factory.createPropertyAssignment(ts.factory.createIdentifier("columns"), ts.factory.createIdentifier("columns")),
+        ts.factory.createPropertyAssignment(ts.factory.createIdentifier("name"), ts.factory.createStringLiteral(schemaTitle)),
+        ts.factory.createShorthandPropertyAssignment(ts.factory.createIdentifier("auth"), undefined),
+    ], true);
+    const newDatabaseClient = ts.factory.createNewExpression(ts.factory.createIdentifier("DatabaseClient"), [
+        createDatabaseDefinitionOfColumnsTypeReference(),
+    ], [clientConfigObject]);
+    return ts.factory.createVariableStatement([ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)], ts.factory.createVariableDeclarationList([
+        ts.factory.createVariableDeclaration(ts.factory.createIdentifier(databaseName), undefined, undefined, ts.factory.createArrowFunction(undefined, undefined, [
+            ts.factory.createParameterDeclaration(undefined, undefined, ts.factory.createIdentifier("auth"), undefined, ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword), undefined),
+        ], undefined, ts.factory.createToken(ts.SyntaxKind.EqualsGreaterThanToken), ts.factory.createBlock([ts.factory.createReturnStatement(newDatabaseClient)], true))),
+    ], ts.NodeFlags.Const));
+}
+//# sourceMappingURL=ast-builders.js.map

package/build/src/ast/shared/ast-builders.js.map

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

package/build/src/ast/shared/cached-metadata.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared metadata schema and read helpers for database and agent caches.
+ * Keeps a single shape so index emission can treat both uniformly.
+ */
+import { z } from "zod";
+declare const cachedEntityMetadataSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    displayName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    displayName: string;
+}, {
+    name: string;
+    id: string;
+    displayName: string;
+}>;
+export type CachedEntityMetadata = z.infer<typeof cachedEntityMetadataSchema>;
+export declare function parseMetadataArray(content: string): CachedEntityMetadata[];
+/** Loads cached database metadata used for incremental generation and index emit. */
+export declare function readDatabaseMetadata(): CachedEntityMetadata[];
+/** Loads cached agent metadata so source index emission can include both databases and agents. */
+export declare function readAgentMetadataFromDisk(): CachedEntityMetadata[];
+export {};
+//# sourceMappingURL=cached-metadata.d.ts.map

package/build/src/ast/shared/cached-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-metadata.d.ts","sourceRoot":"","sources":["../../../../src/ast/shared/cached-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,0BAA0B;;;;;;;;;;;;EAI9B,CAAC;AAWH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAmC9E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAa1E;AAeD,qFAAqF;AACrF,wBAAgB,oBAAoB,IAAI,oBAAoB,EAAE,CAE7D;AAED,kGAAkG;AAClG,wBAAgB,yBAAyB,IAAI,oBAAoB,EAAE,CAElE"}

package/build/src/ast/shared/cached-metadata.js

@@ -0,0 +1,76 @@
+/**
+ * Shared metadata schema and read helpers for database and agent caches.
+ * Keeps a single shape so index emission can treat both uniformly.
+ */
+import fs from "fs";
+import { z } from "zod";
+import { toUndashedNotionId } from "../../helpers.js";
+import { AST_FS_PATHS } from "./constants.js";
+const cachedEntityMetadataSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    displayName: z.string(),
+});
+const legacyCachedEntityMetadataSchema = z.object({
+    id: z.string(),
+    className: z.string().optional(),
+    displayName: z.string(),
+    camelCaseName: z.string(),
+});
+const cachedEntityMetadataArraySchema = z.array(z.union([cachedEntityMetadataSchema, legacyCachedEntityMetadataSchema]));
+function toNormalizableEntry(entry) {
+    if ("name" in entry) {
+        return { kind: "current", ...entry };
+    }
+    return { kind: "legacy", ...entry };
+}
+function normalizeMetadataEntry(entry) {
+    if (entry.kind === "current") {
+        return {
+            id: toUndashedNotionId(entry.id),
+            name: entry.name,
+            displayName: entry.displayName,
+        };
+    }
+    return {
+        id: toUndashedNotionId(entry.id),
+        name: entry.camelCaseName,
+        displayName: entry.displayName,
+    };
+}
+export function parseMetadataArray(content) {
+    let parsedContent;
+    try {
+        parsedContent = JSON.parse(content);
+    }
+    catch {
+        return [];
+    }
+    const parseResult = cachedEntityMetadataArraySchema.safeParse(parsedContent);
+    if (!parseResult.success) {
+        return [];
+    }
+    return parseResult.data.map(toNormalizableEntry).map(normalizeMetadataEntry);
+}
+/** Reads metadata from disk; returns [] if file missing or unparseable. */
+function readMetadataFromDisk(filePath) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return [];
+        }
+        const content = fs.readFileSync(filePath, "utf-8");
+        return parseMetadataArray(content);
+    }
+    catch {
+        return [];
+    }
+}
+/** Loads cached database metadata used for incremental generation and index emit. */
+export function readDatabaseMetadata() {
+    return readMetadataFromDisk(AST_FS_PATHS.metadataFile);
+}
+/** Loads cached agent metadata so source index emission can include both databases and agents. */
+export function readAgentMetadataFromDisk() {
+    return readMetadataFromDisk(AST_FS_PATHS.agentMetadataFile);
+}
+//# sourceMappingURL=cached-metadata.js.map

package/build/src/ast/shared/cached-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-metadata.js","sourceRoot":"","sources":["../../../../src/ast/shared/cached-metadata.ts"],"names":[],"mappings":"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"}

package/build/src/ast/shared/codegen-diagnostics.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Optional sink for codegen warnings/errors so CLI can buffer output until
+ * progress UI is torn down.
+ */
+export type CodegenDiagnosticLevel = "warn" | "error";
+export type CodegenDiagnostic = {
+    level: CodegenDiagnosticLevel;
+    message: string;
+};
+export type CodegenDiagnosticSink = (diagnostic: CodegenDiagnostic) => void;
+/** Human-readable line for skipped / unsupported columns (sync UX). */
+export declare function formatCodegenSkippedPropertyLine(args: {
+    databaseDisplayName: string;
+    propertyName: string;
+    notionType: string;
+}): string;
+/** Select / multi_select column where the handler did not yield an options identifier. */
+export declare function formatCodegenMissingOptionsIdentifierLine(args: {
+    databaseModuleName: string;
+    propertyName: string;
+    propertyType: string;
+}): string;
+//# sourceMappingURL=codegen-diagnostics.d.ts.map

package/build/src/ast/shared/codegen-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen-diagnostics.d.ts","sourceRoot":"","sources":["../../../../src/ast/shared/codegen-diagnostics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAE5E,uEAAuE;AACvE,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACtD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAET;AAED,0FAA0F;AAC1F,wBAAgB,yCAAyC,CAAC,IAAI,EAAE;IAC/D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAET"}

package/build/src/ast/shared/codegen-diagnostics.js

@@ -0,0 +1,13 @@
+/**
+ * Optional sink for codegen warnings/errors so CLI can buffer output until
+ * progress UI is torn down.
+ */
+/** Human-readable line for skipped / unsupported columns (sync UX). */
+export function formatCodegenSkippedPropertyLine(args) {
+    return `[${args.databaseDisplayName}] \`${args.propertyName}\` (${args.notionType}) was skipped`;
+}
+/** Select / multi_select column where the handler did not yield an options identifier. */
+export function formatCodegenMissingOptionsIdentifierLine(args) {
+    return `[${args.databaseModuleName}] Missing options identifier for \`${args.propertyName}\` (${args.propertyType}); skipping.`;
+}
+//# sourceMappingURL=codegen-diagnostics.js.map

package/build/src/ast/shared/codegen-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen-diagnostics.js","sourceRoot":"","sources":["../../../../src/ast/shared/codegen-diagnostics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,uEAAuE;AACvE,MAAM,UAAU,gCAAgC,CAAC,IAIhD;IACA,OAAO,IAAI,IAAI,CAAC,mBAAmB,OAAO,IAAI,CAAC,YAAY,OAAO,IAAI,CAAC,UAAU,eAAe,CAAC;AAClG,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,yCAAyC,CAAC,IAIzD;IACA,OAAO,IAAI,IAAI,CAAC,kBAAkB,sCAAsC,IAAI,CAAC,YAAY,OAAO,IAAI,CAAC,YAAY,cAAc,CAAC;AACjI,CAAC"}

package/build/src/ast/shared/codegen-environment.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Codegen extension rules (central source of truth for TS vs JS choices):
+ *
+ *   Rule 1 (env-driven). Per-file ARTIFACT extension is `.ts` or `.js` based
+ *            on the consumer project's environment. Compose filenames with
+ *            `codegenArtifactFileName(basename, env)` (or
+ *            `getCodegenArtifactExtension(env)` only when you need the raw
+ *            extension) — never inline the TS/JS ternary.
+ *   Rule 2 (constant).   Relative IMPORT SPECIFIERS inside generated `.ts`
+ *            and `.d.ts` modules are always `.js` (TS ESM NodeNext pattern
+ *            so emitted JS and Node resolution line up). Use
+ *            `getCodegenImportExtension()`.
+ *   Rule 3 (constant).   DECLARATION artifacts are always `.d.ts` /
+ *            `.d.ts.map` regardless of environment (see
+ *            `AST_FS_FILENAMES.INDEX_DTS` / `INDEX_DTS_MAP`).
+ *
+ * New env-dependent file locations should go through
+ * `codegenIndexSourcePath` (for `index.{ts,js}`-shaped outputs) rather than
+ * reintroducing `Ts`/`Js` paired constants.
+ */
+export type CodegenEnvironment = "typescript" | "javascript";
+type CodegenConfigRuntime = {
+    isTS: boolean;
+};
+export declare function resolveCodegenEnvironment(args?: {
+    projectRoot?: string;
+    configRuntime?: CodegenConfigRuntime;
+}): CodegenEnvironment;
+/**
+ * Environment-aware artifact filename: `{basename}.{ts|js}`.
+ * Use for on-disk module paths and relative `./Foo.{ts|js}` import paths in
+ * emitted registries — do not interpolate `getCodegenArtifactExtension` by hand.
+ */
+export declare function codegenArtifactFileName(basename: string, environment: CodegenEnvironment): string;
+export declare function getCodegenImportExtension(): "js";
+export {};
+//# sourceMappingURL=codegen-environment.d.ts.map