@objectstack/spec 3.0.10 → 3.1.0

package/dist/app-install.zod-TL0VEjw0.d.ts

@@ -0,0 +1,781 @@
+import { z } from 'zod';
+
+/**
+ * Metadata Scope Enum
+ * Defines the lifecycle and mutability of a metadata item.
+ */
+declare const MetadataScopeSchema: z.ZodEnum<{
+    user: "user";
+    system: "system";
+    platform: "platform";
+}>;
+/**
+ * Metadata Lifecycle State
+ */
+declare const MetadataStateSchema: z.ZodEnum<{
+    deprecated: "deprecated";
+    active: "active";
+    archived: "archived";
+    draft: "draft";
+}>;
+/**
+ * Unified Metadata Persistence Protocol
+ *
+ * Defines the standardized envelope for storing ANY metadata item (Object, View, Flow)
+ * in the database (e.g. `_framework_metadata` or generic `metadata` table).
+ *
+ * This treats "Metadata as Data".
+ */
+declare const MetadataRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodString;
+    namespace: z.ZodDefault<z.ZodString>;
+    packageId: z.ZodOptional<z.ZodString>;
+    managedBy: z.ZodOptional<z.ZodEnum<{
+        user: "user";
+        package: "package";
+        platform: "platform";
+    }>>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        user: "user";
+        system: "system";
+        platform: "platform";
+    }>>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    extends: z.ZodOptional<z.ZodString>;
+    strategy: z.ZodDefault<z.ZodEnum<{
+        replace: "replace";
+        merge: "merge";
+    }>>;
+    owner: z.ZodOptional<z.ZodString>;
+    state: z.ZodDefault<z.ZodEnum<{
+        deprecated: "deprecated";
+        active: "active";
+        archived: "archived";
+        draft: "draft";
+    }>>;
+    tenantId: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodNumber>;
+    checksum: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<{
+        database: "database";
+        api: "api";
+        filesystem: "filesystem";
+        migration: "migration";
+    }>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    publishedDefinition: z.ZodOptional<z.ZodUnknown>;
+    publishedAt: z.ZodOptional<z.ZodString>;
+    publishedBy: z.ZodOptional<z.ZodString>;
+    createdBy: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type MetadataRecord = z.infer<typeof MetadataRecordSchema>;
+type MetadataScope = z.infer<typeof MetadataScopeSchema>;
+/**
+ * Package Publish Result
+ * Returned by `publishPackage()` after a package-level metadata publish operation.
+ */
+declare const PackagePublishResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    packageId: z.ZodString;
+    version: z.ZodNumber;
+    publishedAt: z.ZodString;
+    itemsPublished: z.ZodNumber;
+    validationErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        name: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type PackagePublishResult = z.infer<typeof PackagePublishResultSchema>;
+/**
+ * Metadata Format
+ * Supported file formats for metadata serialization.
+ */
+declare const MetadataFormatSchema: z.ZodEnum<{
+    javascript: "javascript";
+    yaml: "yaml";
+    json: "json";
+    typescript: "typescript";
+    yml: "yml";
+    ts: "ts";
+    js: "js";
+}>;
+/**
+ * Metadata Stats
+ * Statistics about a metadata item.
+ */
+declare const MetadataStatsSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    mtime: z.ZodOptional<z.ZodString>;
+    hash: z.ZodOptional<z.ZodString>;
+    etag: z.ZodOptional<z.ZodString>;
+    modifiedAt: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        javascript: "javascript";
+        yaml: "yaml";
+        json: "json";
+        typescript: "typescript";
+        yml: "yml";
+        ts: "ts";
+        js: "js";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Metadata Loader Contract
+ * Describes the capabilities and identity of a metadata loader.
+ */
+declare const MetadataLoaderContractSchema: z.ZodObject<{
+    name: z.ZodString;
+    protocol: z.ZodEnum<{
+        "file:": "file:";
+        "http:": "http:";
+        "s3:": "s3:";
+        "datasource:": "datasource:";
+        "memory:": "memory:";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    supportedFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supportsWatch: z.ZodOptional<z.ZodBoolean>;
+    supportsWrite: z.ZodOptional<z.ZodBoolean>;
+    supportsCache: z.ZodOptional<z.ZodBoolean>;
+    capabilities: z.ZodObject<{
+        read: z.ZodDefault<z.ZodBoolean>;
+        write: z.ZodDefault<z.ZodBoolean>;
+        watch: z.ZodDefault<z.ZodBoolean>;
+        list: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Metadata Load Options
+ */
+declare const MetadataLoadOptionsSchema: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodEnum<{
+        user: "user";
+        system: "system";
+        platform: "platform";
+    }>>;
+    namespace: z.ZodOptional<z.ZodString>;
+    raw: z.ZodOptional<z.ZodBoolean>;
+    cache: z.ZodOptional<z.ZodBoolean>;
+    useCache: z.ZodOptional<z.ZodBoolean>;
+    validate: z.ZodOptional<z.ZodBoolean>;
+    ifNoneMatch: z.ZodOptional<z.ZodString>;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    loader: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Metadata Load Result
+ */
+declare const MetadataLoadResultSchema: z.ZodObject<{
+    data: z.ZodUnknown;
+    stats: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        mtime: z.ZodOptional<z.ZodString>;
+        hash: z.ZodOptional<z.ZodString>;
+        etag: z.ZodOptional<z.ZodString>;
+        modifiedAt: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodEnum<{
+            javascript: "javascript";
+            yaml: "yaml";
+            json: "json";
+            typescript: "typescript";
+            yml: "yml";
+            ts: "ts";
+            js: "js";
+        }>>;
+    }, z.core.$strip>>;
+    format: z.ZodOptional<z.ZodEnum<{
+        javascript: "javascript";
+        yaml: "yaml";
+        json: "json";
+        typescript: "typescript";
+        yml: "yml";
+        ts: "ts";
+        js: "js";
+    }>>;
+    source: z.ZodOptional<z.ZodString>;
+    fromCache: z.ZodOptional<z.ZodBoolean>;
+    etag: z.ZodOptional<z.ZodString>;
+    notModified: z.ZodOptional<z.ZodBoolean>;
+    loadTime: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Metadata Save Options
+ */
+declare const MetadataSaveOptionsSchema: z.ZodObject<{
+    format: z.ZodOptional<z.ZodEnum<{
+        javascript: "javascript";
+        yaml: "yaml";
+        json: "json";
+        typescript: "typescript";
+        yml: "yml";
+        ts: "ts";
+        js: "js";
+    }>>;
+    create: z.ZodDefault<z.ZodBoolean>;
+    overwrite: z.ZodDefault<z.ZodBoolean>;
+    path: z.ZodOptional<z.ZodString>;
+    prettify: z.ZodOptional<z.ZodBoolean>;
+    indent: z.ZodOptional<z.ZodNumber>;
+    sortKeys: z.ZodOptional<z.ZodBoolean>;
+    backup: z.ZodOptional<z.ZodBoolean>;
+    atomic: z.ZodOptional<z.ZodBoolean>;
+    loader: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Metadata Save Result
+ */
+declare const MetadataSaveResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    path: z.ZodOptional<z.ZodString>;
+    stats: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        mtime: z.ZodOptional<z.ZodString>;
+        hash: z.ZodOptional<z.ZodString>;
+        etag: z.ZodOptional<z.ZodString>;
+        modifiedAt: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodEnum<{
+            javascript: "javascript";
+            yaml: "yaml";
+            json: "json";
+            typescript: "typescript";
+            yml: "yml";
+            ts: "ts";
+            js: "js";
+        }>>;
+    }, z.core.$strip>>;
+    etag: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    saveTime: z.ZodOptional<z.ZodNumber>;
+    backupPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Metadata Watch Event
+ */
+declare const MetadataWatchEventSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        add: "add";
+        change: "change";
+        unlink: "unlink";
+        added: "added";
+        changed: "changed";
+        deleted: "deleted";
+    }>;
+    path: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    stats: z.ZodOptional<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        mtime: z.ZodOptional<z.ZodString>;
+        hash: z.ZodOptional<z.ZodString>;
+        etag: z.ZodOptional<z.ZodString>;
+        modifiedAt: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodEnum<{
+            javascript: "javascript";
+            yaml: "yaml";
+            json: "json";
+            typescript: "typescript";
+            yml: "yml";
+            ts: "ts";
+            js: "js";
+        }>>;
+    }, z.core.$strip>>;
+    metadataType: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodUnknown>;
+    timestamp: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Metadata Collection Info
+ */
+declare const MetadataCollectionInfoSchema: z.ZodObject<{
+    type: z.ZodString;
+    count: z.ZodNumber;
+    namespaces: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Metadata Export/Import Options
+ */
+declare const MetadataExportOptionsSchema: z.ZodObject<{
+    types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    namespaces: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    output: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<{
+        javascript: "javascript";
+        yaml: "yaml";
+        json: "json";
+        typescript: "typescript";
+        yml: "yml";
+        ts: "ts";
+        js: "js";
+    }>>;
+}, z.core.$strip>;
+declare const MetadataImportOptionsSchema: z.ZodObject<{
+    source: z.ZodString;
+    strategy: z.ZodDefault<z.ZodEnum<{
+        replace: "replace";
+        skip: "skip";
+        merge: "merge";
+    }>>;
+    validate: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Metadata Fallback Strategy
+ * Determines behavior when the primary datasource is unavailable.
+ */
+declare const MetadataFallbackStrategySchema: z.ZodEnum<{
+    none: "none";
+    memory: "memory";
+    filesystem: "filesystem";
+}>;
+/**
+ * Metadata Source Origin
+ * Indicates where a metadata record was loaded from.
+ */
+declare const MetadataSourceSchema: z.ZodEnum<{
+    database: "database";
+    api: "api";
+    filesystem: "filesystem";
+    migration: "migration";
+}>;
+/**
+ * Metadata Manager Config
+ *
+ * Unified configuration for the MetadataManager.
+ * Supports datasource-backed persistence via `datasource` field,
+ * which references a DatasourceSchema.name resolved at runtime.
+ */
+declare const MetadataManagerConfigSchema: z.ZodObject<{
+    datasource: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodDefault<z.ZodString>;
+    fallback: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        memory: "memory";
+        filesystem: "filesystem";
+    }>>;
+    rootDir: z.ZodOptional<z.ZodString>;
+    formats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        javascript: "javascript";
+        yaml: "yaml";
+        json: "json";
+        typescript: "typescript";
+        yml: "yml";
+        ts: "ts";
+        js: "js";
+    }>>>;
+    watch: z.ZodOptional<z.ZodBoolean>;
+    cache: z.ZodOptional<z.ZodBoolean>;
+    watchOptions: z.ZodOptional<z.ZodObject<{
+        ignored: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        persistent: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type MetadataFormat = z.infer<typeof MetadataFormatSchema>;
+type MetadataStats = z.infer<typeof MetadataStatsSchema>;
+type MetadataLoaderContract = z.input<typeof MetadataLoaderContractSchema>;
+type MetadataLoadOptions = z.infer<typeof MetadataLoadOptionsSchema>;
+type MetadataLoadResult = z.infer<typeof MetadataLoadResultSchema>;
+type MetadataSaveOptions = z.infer<typeof MetadataSaveOptionsSchema>;
+type MetadataSaveResult = z.infer<typeof MetadataSaveResultSchema>;
+type MetadataWatchEvent = z.infer<typeof MetadataWatchEventSchema>;
+type MetadataCollectionInfo = z.infer<typeof MetadataCollectionInfoSchema>;
+type MetadataExportOptions = z.infer<typeof MetadataExportOptionsSchema>;
+type MetadataImportOptions = z.infer<typeof MetadataImportOptionsSchema>;
+type MetadataManagerConfig = z.input<typeof MetadataManagerConfigSchema>;
+type MetadataFallbackStrategy = z.infer<typeof MetadataFallbackStrategySchema>;
+type MetadataSource = z.infer<typeof MetadataSourceSchema>;
+
+/**
+ * Tenant Provisioning Protocol
+ *
+ * Defines the schemas for the "Register → Instant ObjectOS" provisioning pipeline:
+ * 1. User registers → ProvisioningRequest created
+ * 2. Turso database created → Schema synced → Seed data applied
+ * 3. Tenant status transitions: provisioning → active
+ *
+ * Provisioning is designed to be:
+ * - **Idempotent**: Re-running the same request produces the same result
+ * - **Observable**: Each step has explicit status tracking
+ * - **Fast**: Target 2-5 seconds for complete provisioning
+ */
+/**
+ * Tenant provisioning lifecycle status.
+ */
+declare const TenantProvisioningStatusEnum: z.ZodEnum<{
+    active: "active";
+    failed: "failed";
+    provisioning: "provisioning";
+    suspended: "suspended";
+    destroying: "destroying";
+}>;
+type TenantProvisioningStatus = z.infer<typeof TenantProvisioningStatusEnum>;
+/**
+ * Tenant subscription plan.
+ */
+declare const TenantPlanSchema: z.ZodEnum<{
+    free: "free";
+    pro: "pro";
+    enterprise: "enterprise";
+}>;
+type TenantPlan = z.infer<typeof TenantPlanSchema>;
+/**
+ * Available deployment regions.
+ */
+declare const TenantRegionSchema: z.ZodEnum<{
+    "us-east": "us-east";
+    "us-west": "us-west";
+    "eu-west": "eu-west";
+    "eu-central": "eu-central";
+    "ap-southeast": "ap-southeast";
+    "ap-northeast": "ap-northeast";
+}>;
+type TenantRegion = z.infer<typeof TenantRegionSchema>;
+/**
+ * Individual provisioning step status.
+ * Tracks the progress of each step in the provisioning pipeline.
+ */
+declare const ProvisioningStepSchema: z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodEnum<{
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        pending: "pending";
+        skipped: "skipped";
+    }>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ProvisioningStep = z.infer<typeof ProvisioningStepSchema>;
+/**
+ * Tenant Provisioning Request.
+ * Input for creating a new tenant with its isolated database.
+ */
+declare const TenantProvisioningRequestSchema: z.ZodObject<{
+    orgId: z.ZodString;
+    plan: z.ZodDefault<z.ZodEnum<{
+        free: "free";
+        pro: "pro";
+        enterprise: "enterprise";
+    }>>;
+    region: z.ZodDefault<z.ZodEnum<{
+        "us-east": "us-east";
+        "us-west": "us-west";
+        "eu-west": "eu-west";
+        "eu-central": "eu-central";
+        "ap-southeast": "ap-southeast";
+        "ap-northeast": "ap-northeast";
+    }>>;
+    displayName: z.ZodOptional<z.ZodString>;
+    adminEmail: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type TenantProvisioningRequest = z.infer<typeof TenantProvisioningRequestSchema>;
+/**
+ * Tenant Provisioning Result.
+ * Output after provisioning completes (or fails).
+ */
+declare const TenantProvisioningResultSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    connectionUrl: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        failed: "failed";
+        provisioning: "provisioning";
+        suspended: "suspended";
+        destroying: "destroying";
+    }>;
+    region: z.ZodEnum<{
+        "us-east": "us-east";
+        "us-west": "us-west";
+        "eu-west": "eu-west";
+        "eu-central": "eu-central";
+        "ap-southeast": "ap-southeast";
+        "ap-northeast": "ap-northeast";
+    }>;
+    plan: z.ZodEnum<{
+        free: "free";
+        pro: "pro";
+        enterprise: "enterprise";
+    }>;
+    steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+            pending: "pending";
+            skipped: "skipped";
+        }>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    totalDurationMs: z.ZodOptional<z.ZodNumber>;
+    provisionedAt: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type TenantProvisioningResult = z.infer<typeof TenantProvisioningResultSchema>;
+
+/**
+ * Deploy Bundle Protocol
+ *
+ * Defines the schemas for metadata-driven deployment:
+ * Schema Push → Zod Validate → Diff → DDL Sync → Register
+ *
+ * This eliminates traditional CI/CD pipelines for schema changes.
+ * A "deploy" is a bundle of metadata (objects, views, flows, permissions)
+ * that is validated, diffed against the current state, and applied
+ * as DDL migrations directly to the tenant database.
+ *
+ * Target: 2-5 second deploys vs. 2-15 minute traditional Docker/CI/CD.
+ */
+/**
+ * Deployment lifecycle status.
+ */
+declare const DeployStatusEnum: z.ZodEnum<{
+    failed: "failed";
+    validating: "validating";
+    diffing: "diffing";
+    migrating: "migrating";
+    registering: "registering";
+    ready: "ready";
+    rolling_back: "rolling_back";
+}>;
+type DeployStatus = z.infer<typeof DeployStatusEnum>;
+/**
+ * Schema change descriptor for a single entity (object/field).
+ */
+declare const SchemaChangeSchema: z.ZodObject<{
+    entityType: z.ZodEnum<{
+        object: "object";
+        field: "field";
+        index: "index";
+        view: "view";
+        flow: "flow";
+        permission: "permission";
+    }>;
+    entityName: z.ZodString;
+    parentEntity: z.ZodOptional<z.ZodString>;
+    changeType: z.ZodEnum<{
+        removed: "removed";
+        added: "added";
+        modified: "modified";
+    }>;
+    oldValue: z.ZodOptional<z.ZodUnknown>;
+    newValue: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type SchemaChange = z.infer<typeof SchemaChangeSchema>;
+/**
+ * Deploy Diff — what changed between current and desired state.
+ */
+declare const DeployDiffSchema: z.ZodObject<{
+    changes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        entityType: z.ZodEnum<{
+            object: "object";
+            field: "field";
+            index: "index";
+            view: "view";
+            flow: "flow";
+            permission: "permission";
+        }>;
+        entityName: z.ZodString;
+        parentEntity: z.ZodOptional<z.ZodString>;
+        changeType: z.ZodEnum<{
+            removed: "removed";
+            added: "added";
+            modified: "modified";
+        }>;
+        oldValue: z.ZodOptional<z.ZodUnknown>;
+        newValue: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    summary: z.ZodObject<{
+        added: z.ZodDefault<z.ZodNumber>;
+        modified: z.ZodDefault<z.ZodNumber>;
+        removed: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    hasBreakingChanges: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type DeployDiff = z.infer<typeof DeployDiffSchema>;
+/**
+ * A single DDL migration statement.
+ */
+declare const MigrationStatementSchema: z.ZodObject<{
+    sql: z.ZodString;
+    reversible: z.ZodDefault<z.ZodBoolean>;
+    rollbackSql: z.ZodOptional<z.ZodString>;
+    order: z.ZodNumber;
+}, z.core.$strip>;
+type MigrationStatement = z.infer<typeof MigrationStatementSchema>;
+/**
+ * Migration Plan — ordered list of DDL statements to execute.
+ */
+declare const MigrationPlanSchema: z.ZodObject<{
+    statements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        sql: z.ZodString;
+        reversible: z.ZodDefault<z.ZodBoolean>;
+        rollbackSql: z.ZodOptional<z.ZodString>;
+        order: z.ZodNumber;
+    }, z.core.$strip>>>;
+    dialect: z.ZodString;
+    reversible: z.ZodDefault<z.ZodBoolean>;
+    estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type MigrationPlan = z.infer<typeof MigrationPlanSchema>;
+/**
+ * Validation issue found during bundle validation.
+ */
+declare const DeployValidationIssueSchema: z.ZodObject<{
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+        info: "info";
+    }>;
+    path: z.ZodString;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type DeployValidationIssue = z.infer<typeof DeployValidationIssueSchema>;
+/**
+ * Zod validation result for the entire deploy bundle.
+ */
+declare const DeployValidationResultSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+        }>;
+        path: z.ZodString;
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    errorCount: z.ZodDefault<z.ZodNumber>;
+    warningCount: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type DeployValidationResult = z.infer<typeof DeployValidationResultSchema>;
+/**
+ * Deploy Manifest — metadata about the deployment.
+ */
+declare const DeployManifestSchema: z.ZodObject<{
+    version: z.ZodString;
+    checksum: z.ZodOptional<z.ZodString>;
+    objects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    views: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    flows: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    permissions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type DeployManifest = z.infer<typeof DeployManifestSchema>;
+/**
+ * Deploy Bundle — container for all metadata being deployed.
+ * This is the primary input to the deploy pipeline.
+ */
+declare const DeployBundleSchema: z.ZodObject<{
+    manifest: z.ZodObject<{
+        version: z.ZodString;
+        checksum: z.ZodOptional<z.ZodString>;
+        objects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        views: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        flows: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        permissions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    objects: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    views: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    flows: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    permissions: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    seedData: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+type DeployBundle = z.infer<typeof DeployBundleSchema>;
+
+/**
+ * App Installation Protocol
+ *
+ * Defines the schemas for installing marketplace apps into tenant databases.
+ * An "app install" injects metadata (objects, views, flows) + schema sync
+ * into a tenant's isolated database.
+ *
+ * Install pipeline:
+ * 1. Check compatibility (kernel version, existing objects, conflicts)
+ * 2. Validate app manifest
+ * 3. Apply schema changes (via deploy pipeline)
+ * 4. Seed initial data
+ * 5. Register app in tenant's metadata registry
+ */
+/**
+ * App Manifest — describes an installable app package.
+ */
+declare const AppManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    minKernelVersion: z.ZodOptional<z.ZodString>;
+    objects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    views: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    flows: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    hasSeedData: z.ZodDefault<z.ZodBoolean>;
+    seedData: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type AppManifest = z.infer<typeof AppManifestSchema>;
+/**
+ * App Compatibility Check Result.
+ */
+declare const AppCompatibilityCheckSchema: z.ZodObject<{
+    compatible: z.ZodBoolean;
+    issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        category: z.ZodEnum<{
+            kernel_version: "kernel_version";
+            object_conflict: "object_conflict";
+            dependency_missing: "dependency_missing";
+            quota_exceeded: "quota_exceeded";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type AppCompatibilityCheck = z.infer<typeof AppCompatibilityCheckSchema>;
+/**
+ * App Install Request.
+ */
+declare const AppInstallRequestSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    appId: z.ZodString;
+    configOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    skipSeedData: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type AppInstallRequest = z.infer<typeof AppInstallRequestSchema>;
+/**
+ * App Install Result.
+ */
+declare const AppInstallResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    appId: z.ZodString;
+    version: z.ZodString;
+    installedObjects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    createdTables: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    seededRecords: z.ZodDefault<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type AppInstallResult = z.infer<typeof AppInstallResultSchema>;
+
+export { type MetadataSource as $, type AppManifest as A, type MetadataFallbackStrategy as B, MetadataFallbackStrategySchema as C, type DeployDiff as D, type MetadataFormat as E, MetadataFormatSchema as F, type MetadataImportOptions as G, MetadataImportOptionsSchema as H, type MetadataLoadOptions as I, MetadataLoadOptionsSchema as J, type MetadataLoadResult as K, MetadataLoadResultSchema as L, type MigrationPlan as M, type MetadataLoaderContract as N, MetadataLoaderContractSchema as O, type PackagePublishResult as P, type MetadataManagerConfig as Q, MetadataManagerConfigSchema as R, type MetadataRecord as S, type TenantProvisioningRequest as T, MetadataRecordSchema as U, type MetadataSaveOptions as V, MetadataSaveOptionsSchema as W, type MetadataSaveResult as X, MetadataSaveResultSchema as Y, type MetadataScope as Z, MetadataScopeSchema as _, type TenantProvisioningResult as a, MetadataSourceSchema as a0, MetadataStateSchema as a1, type MetadataStats as a2, MetadataStatsSchema as a3, type MetadataWatchEvent as a4, MetadataWatchEventSchema as a5, MigrationPlanSchema as a6, type MigrationStatement as a7, MigrationStatementSchema as a8, PackagePublishResultSchema as a9, type ProvisioningStep as aa, ProvisioningStepSchema as ab, type SchemaChange as ac, SchemaChangeSchema as ad, TenantPlanSchema as ae, TenantProvisioningRequestSchema as af, TenantProvisioningResultSchema as ag, TenantProvisioningStatusEnum as ah, TenantRegionSchema as ai, type TenantProvisioningStatus as b, type TenantPlan as c, type DeployStatus as d, type DeployBundle as e, type DeployValidationResult as f, type TenantRegion as g, type AppCompatibilityCheck as h, type AppInstallResult as i, AppCompatibilityCheckSchema as j, type AppInstallRequest as k, AppInstallRequestSchema as l, AppInstallResultSchema as m, AppManifestSchema as n, DeployBundleSchema as o, DeployDiffSchema as p, type DeployManifest as q, DeployManifestSchema as r, DeployStatusEnum as s, type DeployValidationIssue as t, DeployValidationIssueSchema as u, DeployValidationResultSchema as v, type MetadataCollectionInfo as w, MetadataCollectionInfoSchema as x, type MetadataExportOptions as y, MetadataExportOptionsSchema as z };