@supatype/plugin-sdk 0.1.0-alpha.9

package/dist/define.js

@@ -0,0 +1,165 @@
+/**
+ * Builder functions for defining Supatype plugins.
+ *
+ * These are the primary API surface for plugin authors:
+ *   defineFieldType()  — custom field types (e.g., phone, currency)
+ *   defineComposite()  — field bundles (e.g., SEO, address)
+ *   defineProvider()   — service providers (e.g., Stripe, PostHog)
+ *   defineWidget()     — admin panel widgets (e.g., color picker)
+ */
+import { PLUGIN_API_VERSION, } from "./types.js";
+// ─── defineFieldType ─────────────────────────────────────────────────────────
+/**
+ * Define a custom field type plugin.
+ *
+ * @example
+ * ```ts
+ * import { defineFieldType } from '@supatype/plugin-sdk'
+ *
+ * export default defineFieldType({
+ *   name: 'phone',
+ *   pgType: 'TEXT',
+ *   tsType: 'string',
+ *   validate(value) {
+ *     if (typeof value !== 'string') return 'Must be a string'
+ *     if (!/^\+\d{7,15}$/.test(value)) return 'Invalid phone number (E.164 format required)'
+ *     return null
+ *   },
+ *   widgetPath: './src/PhoneWidget.tsx',
+ *   filterOperators: ['eq', 'neq', 'in', 'like'],
+ * })
+ * ```
+ */
+export function defineFieldType(definition) {
+    return {
+        ...definition,
+        meta: {
+            name: definition.name,
+            description: `Custom field type: ${definition.name}`,
+            types: ["field"],
+            pluginApi: PLUGIN_API_VERSION,
+            ...definition.meta,
+        },
+        __supatype: "field",
+    };
+}
+// ─── defineComposite ─────────────────────────────────────────────────────────
+/**
+ * Define a composite plugin (field bundle).
+ *
+ * @example
+ * ```ts
+ * import { defineComposite } from '@supatype/plugin-sdk'
+ *
+ * export default defineComposite({
+ *   name: 'seo',
+ *   label: 'SEO Meta',
+ *   fields: [
+ *     { name: 'meta_title', type: 'text', options: { maxLength: 60 } },
+ *     { name: 'meta_description', type: 'text', options: { maxLength: 160 } },
+ *     { name: 'og_image', type: 'text' },
+ *     { name: 'canonical_url', type: 'text' },
+ *     { name: 'no_index', type: 'boolean', defaultValue: false },
+ *   ],
+ *   adminGroup: { collapsible: true, defaultCollapsed: true },
+ * })
+ * ```
+ */
+export function defineComposite(definition) {
+    return {
+        ...definition,
+        meta: {
+            name: definition.name,
+            description: `Composite: ${definition.label}`,
+            types: ["composite"],
+            pluginApi: PLUGIN_API_VERSION,
+            ...definition.meta,
+        },
+        __supatype: "composite",
+    };
+}
+// ─── defineProvider ──────────────────────────────────────────────────────────
+/**
+ * Define a service provider plugin.
+ *
+ * @example
+ * ```ts
+ * import { defineProvider, type CommerceProvider } from '@supatype/plugin-sdk'
+ *
+ * export default defineProvider<StripeConfig>({
+ *   name: 'stripe',
+ *   category: 'commerce',
+ *   label: 'Stripe',
+ *   configSchema: {
+ *     secretKey: { type: 'string', label: 'Secret Key', required: true, secret: true },
+ *     webhookSecret: { type: 'string', label: 'Webhook Secret', required: true, secret: true },
+ *   },
+ *   create(config): CommerceProvider {
+ *     return new StripeCommerceProvider(config)
+ *   },
+ * })
+ * ```
+ */
+export function defineProvider(definition) {
+    return {
+        ...definition,
+        meta: {
+            name: definition.name,
+            description: `${definition.category} provider: ${definition.label}`,
+            types: ["provider"],
+            pluginApi: PLUGIN_API_VERSION,
+            ...definition.meta,
+        },
+        __supatype: "provider",
+    };
+}
+// ─── defineWidget ────────────────────────────────────────────────────────────
+/**
+ * Define a standalone widget plugin.
+ *
+ * @example
+ * ```ts
+ * import { defineWidget } from '@supatype/plugin-sdk'
+ *
+ * export default defineWidget({
+ *   name: 'color-picker',
+ *   label: 'Colour Picker',
+ *   compatibleTypes: ['text', 'varchar'],
+ *   componentPath: './src/ColorPickerWidget.tsx',
+ * })
+ * ```
+ */
+export function defineWidget(definition) {
+    return {
+        ...definition,
+        meta: {
+            name: definition.name,
+            description: `Widget: ${definition.label}`,
+            types: ["widget"],
+            pluginApi: PLUGIN_API_VERSION,
+            ...definition.meta,
+        },
+        __supatype: "widget",
+    };
+}
+/**
+ * Check if a value is a Supatype plugin definition.
+ */
+export function isPluginDefinition(value) {
+    return typeof value === "object" && value !== null && "__supatype" in value;
+}
+/**
+ * Validate plugin API version compatibility.
+ */
+export function checkPluginApiVersion(meta) {
+    if (!meta)
+        return { compatible: true };
+    if (meta.pluginApi !== PLUGIN_API_VERSION) {
+        return {
+            compatible: false,
+            message: `Plugin "${meta.name}" targets plugin API v${meta.pluginApi}, but the current version is v${PLUGIN_API_VERSION}. The plugin may not work correctly.`,
+        };
+    }
+    return { compatible: true };
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,kBAAkB,GAMnB,MAAM,YAAY,CAAA;AAEnB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAuC;IAEvC,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE;YACJ,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,WAAW,EAAE,sBAAsB,UAAU,CAAC,IAAI,EAAE;YACpD,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,SAAS,EAAE,kBAAkB;YAC7B,GAAG,UAAU,CAAC,IAAI;SACnB;QACD,UAAU,EAAE,OAAgB;KAC7B,CAAA;AACH,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA+B;IAE/B,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE;YACJ,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,WAAW,EAAE,cAAc,UAAU,CAAC,KAAK,EAAE;YAC7C,KAAK,EAAE,CAAC,WAAW,CAAC;YACpB,SAAS,EAAE,kBAAkB;YAC7B,GAAG,UAAU,CAAC,IAAI;SACnB;QACD,UAAU,EAAE,WAAoB;KACjC,CAAA;AACH,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAuC;IAEvC,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE;YACJ,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,WAAW,EAAE,GAAG,UAAU,CAAC,QAAQ,cAAc,UAAU,CAAC,KAAK,EAAE;YACnE,KAAK,EAAE,CAAC,UAAU,CAAC;YACnB,SAAS,EAAE,kBAAkB;YAC7B,GAAG,UAAU,CAAC,IAAI;SACnB;QACD,UAAU,EAAE,UAAmB;KAChC,CAAA;AACH,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA4B;IAE5B,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE;YACJ,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,WAAW,EAAE,WAAW,UAAU,CAAC,KAAK,EAAE;YAC1C,KAAK,EAAE,CAAC,QAAQ,CAAC;YACjB,SAAS,EAAE,kBAAkB;YAC7B,GAAG,UAAU,CAAC,IAAI;SACnB;QACD,UAAU,EAAE,QAAiB;KAC9B,CAAA;AACH,CAAC;AAUD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,YAAY,IAAI,KAAK,CAAA;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAIhE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;IAEtC,IAAI,IAAI,CAAC,SAAS,KAAK,kBAAkB,EAAE,CAAC;QAC1C,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,WAAW,IAAI,CAAC,IAAI,yBAAyB,IAAI,CAAC,SAAS,iCAAiC,kBAAkB,sCAAsC;SAC9J,CAAA;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;AAC7B,CAAC"}

package/dist/docgen.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Plugin documentation generator.
+ *
+ * Generates Markdown documentation from a plugin's type definitions.
+ */
+import type { AnyPluginDefinition } from "./define.js";
+/**
+ * Generate Markdown documentation from a plugin definition.
+ *
+ * The output includes YAML frontmatter with the plugin name, type, and version,
+ * followed by type-specific documentation sections.
+ */
+export declare function generatePluginDocs(definition: AnyPluginDefinition): string;
+//# sourceMappingURL=docgen.d.ts.map

package/dist/docgen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docgen.d.ts","sourceRoot":"","sources":["../src/docgen.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAwHtD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAiC1E"}

package/dist/docgen.js

@@ -0,0 +1,135 @@
+/**
+ * Plugin documentation generator.
+ *
+ * Generates Markdown documentation from a plugin's type definitions.
+ */
+function escapeMarkdown(text) {
+    return text.replace(/[|\\`*_{}[\]()#+\-.!]/g, "\\$&");
+}
+function generateFieldDocs(def) {
+    const lines = [];
+    lines.push("## Field Type");
+    lines.push("");
+    lines.push(`| Property | Value |`);
+    lines.push(`| --- | --- |`);
+    lines.push(`| Name | \`${def.name}\` |`);
+    lines.push(`| Postgres Type | \`${def.pgType}\` |`);
+    lines.push(`| TypeScript Type | \`${def.tsType}\` |`);
+    if (def.validate !== undefined) {
+        lines.push(`| Validate | \`${def.validate.toString().slice(0, 80)}\` |`);
+    }
+    if (def.filterOperators !== undefined) {
+        lines.push(`| Filter Operators | ${def.filterOperators.map(o => `\`${o}\``).join(", ")} |`);
+    }
+    if (def.widgetPath !== undefined) {
+        lines.push(`| Widget Path | \`${def.widgetPath}\` |`);
+    }
+    lines.push("");
+    if (def.constraints !== undefined && def.constraints.length > 0) {
+        lines.push("### Constraints");
+        lines.push("");
+        for (const c of def.constraints) {
+            lines.push(`- \`${c}\``);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function generateCompositeDocs(def) {
+    const lines = [];
+    lines.push("## Composite");
+    lines.push("");
+    lines.push(`**Label:** ${escapeMarkdown(def.label)}`);
+    lines.push("");
+    lines.push("### Fields");
+    lines.push("");
+    lines.push(`| Name | Type | Required | Default |`);
+    lines.push(`| --- | --- | --- | --- |`);
+    for (const field of def.fields) {
+        const req = field.required === true ? "Yes" : "No";
+        const defaultVal = field.defaultValue !== undefined ? `\`${String(field.defaultValue)}\`` : "-";
+        lines.push(`| ${field.name} | \`${field.type}\` | ${req} | ${defaultVal} |`);
+    }
+    lines.push("");
+    if (def.adminGroup !== undefined) {
+        lines.push("### Admin Group");
+        lines.push("");
+        if (def.adminGroup.collapsible !== undefined) {
+            lines.push(`- Collapsible: ${def.adminGroup.collapsible}`);
+        }
+        if (def.adminGroup.defaultCollapsed !== undefined) {
+            lines.push(`- Default Collapsed: ${def.adminGroup.defaultCollapsed}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function generateProviderDocs(def) {
+    const lines = [];
+    lines.push("## Provider");
+    lines.push("");
+    lines.push(`**Category:** ${def.category}`);
+    lines.push("");
+    if (def.configSchema && Object.keys(def.configSchema).length > 0) {
+        lines.push("### Config Schema");
+        lines.push("");
+        lines.push(`| Field | Type | Label | Required | Secret |`);
+        lines.push(`| --- | --- | --- | --- | --- |`);
+        for (const [key, schema] of Object.entries(def.configSchema)) {
+            const req = schema.required === true ? "Yes" : "No";
+            const secret = schema.secret === true ? "Yes" : "No";
+            lines.push(`| ${key} | \`${schema.type}\` | ${escapeMarkdown(schema.label)} | ${req} | ${secret} |`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function generateWidgetDocs(def) {
+    const lines = [];
+    lines.push("## Widget");
+    lines.push("");
+    lines.push(`| Property | Value |`);
+    lines.push(`| --- | --- |`);
+    lines.push(`| Name | \`${def.name}\` |`);
+    lines.push(`| Label | ${escapeMarkdown(def.label)} |`);
+    lines.push(`| Compatible Types | ${def.compatibleTypes.map(t => `\`${t}\``).join(", ")} |`);
+    lines.push(`| Component Path | \`${def.componentPath}\` |`);
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Generate Markdown documentation from a plugin definition.
+ *
+ * The output includes YAML frontmatter with the plugin name, type, and version,
+ * followed by type-specific documentation sections.
+ */
+export function generatePluginDocs(definition) {
+    const name = definition.name;
+    const type = definition.__supatype;
+    const version = definition.meta?.pluginApi ?? 1;
+    const frontmatter = [
+        "---",
+        `name: "${name}"`,
+        `type: "${type}"`,
+        `version: ${version}`,
+        "---",
+    ].join("\n");
+    const header = `# ${name}\n`;
+    let body;
+    switch (definition.__supatype) {
+        case "field":
+            body = generateFieldDocs(definition);
+            break;
+        case "composite":
+            body = generateCompositeDocs(definition);
+            break;
+        case "provider":
+            body = generateProviderDocs(definition);
+            break;
+        case "widget":
+            body = generateWidgetDocs(definition);
+            break;
+    }
+    return `${frontmatter}\n\n${header}\n${body}`;
+}
+//# sourceMappingURL=docgen.js.map

package/dist/docgen.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { PLUGIN_API_VERSION, type PluginType, type PluginMeta, type FieldTypeDefinition, type CompositeDefinition, type CompositeFieldDef, type ProviderDefinition, type ProviderCategory, type WidgetDefinition, type WidgetProps, type CommerceProvider, type TrackingProvider, type EmailProvider, type StorageProvider, type AuthProvider, type SSLProvider, } from "./types.js";
+export { defineFieldType, defineComposite, defineProvider, defineWidget, isPluginDefinition, checkPluginApiVersion, type AnyPluginDefinition, } from "./define.js";
+export { generatePluginDocs } from "./docgen.js";
+export { registerPlugin, getRegisteredPlugins, getPluginsByType, getFieldTypePlugin, getProviderPlugin, clearPluginRegistry, isSupatypePlugin, sortByLoadOrder, detectConflicts, validateProviders, getPluginFieldTypeMap, getPluginFieldPgTypeMap, expandPluginComposites, type RegisteredPlugin, type PluginPackageInfo, type PluginConflict, type ProviderValidationResult, type FieldPgTypeInfo, type CompositeExpansion, } from "./loader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGhD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// @supatype/plugin-sdk — Plugin development kit for Supatype extensions
+// Core types
+export { PLUGIN_API_VERSION, } from "./types.js";
+// Builder functions
+export { defineFieldType, defineComposite, defineProvider, defineWidget, isPluginDefinition, checkPluginApiVersion, } from "./define.js";
+// Documentation generator
+export { generatePluginDocs } from "./docgen.js";
+// Plugin loading and registry
+export { registerPlugin, getRegisteredPlugins, getPluginsByType, getFieldTypePlugin, getProviderPlugin, clearPluginRegistry, isSupatypePlugin, sortByLoadOrder, detectConflicts, validateProviders, getPluginFieldTypeMap, getPluginFieldPgTypeMap, expandPluginComposites, } from "./loader.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,aAAa;AACb,OAAO,EACL,kBAAkB,GAgBnB,MAAM,YAAY,CAAA;AAEnB,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,aAAa,CAAA;AAEpB,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD,8BAA8B;AAC9B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,GAOvB,MAAM,aAAa,CAAA"}

package/dist/loader.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Plugin discovery and loading utilities.
+ *
+ * The plugin loader scans node_modules for packages with the `supatype-plugin`
+ * keyword or a `supatype` field in package.json, and auto-registers them.
+ */
+import { type PluginMeta, type PluginType } from "./types.js";
+import { type AnyPluginDefinition } from "./define.js";
+export interface RegisteredPlugin {
+    packageName: string;
+    meta: PluginMeta;
+    definition: AnyPluginDefinition;
+    status: "active" | "inactive" | "incompatible";
+    incompatibleReason?: string | undefined;
+}
+/**
+ * Register a plugin definition.
+ */
+export declare function registerPlugin(packageName: string, definition: AnyPluginDefinition): RegisteredPlugin;
+/**
+ * Get all registered plugins.
+ */
+export declare function getRegisteredPlugins(): RegisteredPlugin[];
+/**
+ * Get plugins by type.
+ */
+export declare function getPluginsByType(type: PluginType): RegisteredPlugin[];
+/**
+ * Get a specific field type plugin by name.
+ */
+export declare function getFieldTypePlugin(name: string): RegisteredPlugin | undefined;
+/**
+ * Get a specific provider plugin by category and name.
+ */
+export declare function getProviderPlugin(category: string, name: string): RegisteredPlugin | undefined;
+/**
+ * Clear the plugin registry (for testing).
+ */
+export declare function clearPluginRegistry(): void;
+export interface PluginPackageInfo {
+    name: string;
+    version: string;
+    description: string;
+    supatype?: {
+        pluginApi?: number | undefined;
+        types?: PluginType[] | undefined;
+    } | undefined;
+    keywords?: string[] | undefined;
+}
+/**
+ * Check if a package.json represents a Supatype plugin.
+ */
+export declare function isSupatypePlugin(pkg: PluginPackageInfo): boolean;
+/**
+ * Sort plugins by load order: providers first, then fields & composites, then widgets.
+ */
+export declare function sortByLoadOrder(plugins: RegisteredPlugin[]): RegisteredPlugin[];
+export interface PluginConflict {
+    type: PluginType;
+    name: string;
+    packages: string[];
+    message: string;
+}
+/**
+ * Detect conflicts between a set of plugin definitions.
+ */
+export declare function detectConflicts(plugins: Array<{
+    packageName: string;
+    definition: AnyPluginDefinition;
+}>): PluginConflict[];
+export interface ProviderValidationResult {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+}
+/**
+ * Validate configured providers at push time.
+ *
+ * For each provider:
+ * - Checks the definition has a `create()` method
+ * - Checks required `configSchema` fields are present in the config
+ * - Warns about optional interface methods not implemented
+ */
+export declare function validateProviders(configuredProviders: Array<{
+    name: string;
+    config?: Record<string, unknown> | undefined;
+}>): ProviderValidationResult;
+/**
+ * Returns a map of custom field type names to their declared `tsType` values
+ * from registered field type plugins. Consumed by the engine's type generator.
+ */
+export declare function getPluginFieldTypeMap(): Map<string, string>;
+export interface FieldPgTypeInfo {
+    pgType: string;
+    constraints?: string[] | undefined;
+}
+/**
+ * Returns a map of custom field type names to their Postgres type and optional
+ * constraints. Consumed by the engine's migration system.
+ */
+export declare function getPluginFieldPgTypeMap(): Map<string, FieldPgTypeInfo>;
+export interface CompositeExpansion {
+    fields: Array<{
+        name: string;
+        pgType: string;
+        required: boolean;
+        defaultValue?: unknown | undefined;
+    }>;
+    installSQL?: string | undefined;
+    uninstallSQL?: string | undefined;
+}
+/**
+ * Expand registered composite plugins into their concrete field definitions
+ * with resolved Postgres types.
+ *
+ * For each composite field, the type is resolved by:
+ * 1. Checking registered plugin field types (from getPluginFieldPgTypeMap)
+ * 2. Falling back to built-in type mappings
+ * 3. Defaulting to TEXT if no match is found
+ */
+export declare function expandPluginComposites(): Map<string, CompositeExpansion>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

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