@vibesdotdev/storage 0.0.1

package/dist/schemas/schema/descriptor.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Storage Schema Descriptor Schema
+ *
+ * Defines a multi-table schema with relations for complex modules.
+ * Used for modules that need multiple related tables with foreign keys.
+ *
+ * @example
+ * ```typescript
+ * const sessionSchemaDescriptor: StorageSchemaDescriptor = {
+ *   kind: 'storage/schema',
+ *   id: 'session',
+ *   name: 'Session Storage Schema',
+ *   description: 'Complete session storage with multiple related tables',
+ *   tables: {
+ *     sessions: {
+ *       schema: SessionSchema,
+ *       primaryKey: 'id',
+ *       indexes: [{ fields: ['status'] }]
+ *     },
+ *     todos: {
+ *       schema: TodoSchema,
+ *       primaryKey: 'id',
+ *       relations: {
+ *         session: { type: 'belongs_to', target: 'sessions', foreignKey: 'sessionId' }
+ *       }
+ *     }
+ *   },
+ *   migrations: () => import('./migrations').then(m => m.SESSION_MIGRATIONS),
+ *   allowedAdapters: ['storage.localdb'],
+ *   dbName: 'sessions.db'
+ * };
+ * ```
+ */
+import * as z from 'zod/v4';
+/**
+ * Table definition within a schema
+ */
+export declare const StorageTableDefinitionSchema: z.ZodObject<{
+    schema: z.ZodUnknown;
+    primaryKey: z.ZodDefault<z.ZodString>;
+    relations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            belongs_to: "belongs_to";
+            has_one: "has_one";
+            has_many: "has_many";
+            many_to_many: "many_to_many";
+        }>;
+        target: z.ZodString;
+        foreignKey: z.ZodOptional<z.ZodString>;
+        foreignKeyTarget: z.ZodOptional<z.ZodString>;
+        through: z.ZodOptional<z.ZodString>;
+        optional: z.ZodDefault<z.ZodBoolean>;
+        cascadeDelete: z.ZodDefault<z.ZodBoolean>;
+        as: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    indexes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        fields: z.ZodArray<z.ZodString>;
+        unique: z.ZodDefault<z.ZodBoolean>;
+        type: z.ZodOptional<z.ZodString>;
+        where: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    timestamps: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        createdAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        updatedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.core.$strip>]>>;
+    autoId: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        field: z.ZodOptional<z.ZodString>;
+        strategy: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            uuid: "uuid";
+            nanoid: "nanoid";
+        }>>;
+        generator: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>]>>;
+    softDelete: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    fieldConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        autoIncrement: z.ZodOptional<z.ZodBoolean>;
+        generator: z.ZodOptional<z.ZodUnknown>;
+        type: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    versioning: z.ZodDefault<z.ZodBoolean>;
+    audit: z.ZodDefault<z.ZodBoolean>;
+    changeTracking: z.ZodDefault<z.ZodBoolean>;
+    validate: z.ZodOptional<z.ZodUnknown>;
+    beforeCreate: z.ZodOptional<z.ZodUnknown>;
+    afterCreate: z.ZodOptional<z.ZodUnknown>;
+    beforeUpdate: z.ZodOptional<z.ZodUnknown>;
+    afterUpdate: z.ZodOptional<z.ZodUnknown>;
+    beforeDelete: z.ZodOptional<z.ZodUnknown>;
+    afterDelete: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * Migration source - can be inline or lazy-loaded
+ */
+export declare const MigrationSourceSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    version: z.ZodNumber;
+    name: z.ZodOptional<z.ZodString>;
+    up: z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>;
+    down: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>>;
+}, z.core.$strip>>, z.ZodUnknown, z.ZodString]>;
+/**
+ * Storage schema descriptor schema
+ */
+export declare const StorageSchemaDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    kind: z.ZodLiteral<"storage/schema">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tables: z.ZodRecord<z.ZodString, z.ZodObject<{
+        schema: z.ZodUnknown;
+        primaryKey: z.ZodDefault<z.ZodString>;
+        relations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                belongs_to: "belongs_to";
+                has_one: "has_one";
+                has_many: "has_many";
+                many_to_many: "many_to_many";
+            }>;
+            target: z.ZodString;
+            foreignKey: z.ZodOptional<z.ZodString>;
+            foreignKeyTarget: z.ZodOptional<z.ZodString>;
+            through: z.ZodOptional<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            cascadeDelete: z.ZodDefault<z.ZodBoolean>;
+            as: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        indexes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            fields: z.ZodArray<z.ZodString>;
+            unique: z.ZodDefault<z.ZodBoolean>;
+            type: z.ZodOptional<z.ZodString>;
+            where: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        timestamps: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            createdAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+            updatedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        }, z.core.$strip>]>>;
+        autoId: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+            strategy: z.ZodOptional<z.ZodEnum<{
+                custom: "custom";
+                uuid: "uuid";
+                nanoid: "nanoid";
+            }>>;
+            generator: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>]>>;
+        softDelete: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        fieldConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            autoIncrement: z.ZodOptional<z.ZodBoolean>;
+            generator: z.ZodOptional<z.ZodUnknown>;
+            type: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>>>;
+        versioning: z.ZodDefault<z.ZodBoolean>;
+        audit: z.ZodDefault<z.ZodBoolean>;
+        changeTracking: z.ZodDefault<z.ZodBoolean>;
+        validate: z.ZodOptional<z.ZodUnknown>;
+        beforeCreate: z.ZodOptional<z.ZodUnknown>;
+        afterCreate: z.ZodOptional<z.ZodUnknown>;
+        beforeUpdate: z.ZodOptional<z.ZodUnknown>;
+        afterUpdate: z.ZodOptional<z.ZodUnknown>;
+        beforeDelete: z.ZodOptional<z.ZodUnknown>;
+        afterDelete: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
+    migrations: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+        version: z.ZodNumber;
+        name: z.ZodOptional<z.ZodString>;
+        up: z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>;
+        down: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>>;
+    }, z.core.$strip>>, z.ZodUnknown, z.ZodString]>>;
+    migrationKey: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodNumber>;
+    allowedAdapters: z.ZodArray<z.ZodString>;
+    defaultAdapter: z.ZodOptional<z.ZodString>;
+    adapterConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        global: "global";
+        project: "project";
+        local: "local";
+        auto: "auto";
+    }>>;
+    dbName: z.ZodOptional<z.ZodString>;
+    dbSchema: z.ZodOptional<z.ZodString>;
+    basePath: z.ZodOptional<z.ZodString>;
+    foreignKeys: z.ZodDefault<z.ZodBoolean>;
+    cascadeDelete: z.ZodDefault<z.ZodBoolean>;
+    transactions: z.ZodDefault<z.ZodBoolean>;
+    pooling: z.ZodDefault<z.ZodBoolean>;
+    poolSize: z.ZodDefault<z.ZodNumber>;
+    sync: z.ZodDefault<z.ZodBoolean>;
+    syncConfig: z.ZodOptional<z.ZodObject<{
+        direction: z.ZodDefault<z.ZodEnum<{
+            bidirectional: "bidirectional";
+            "to-cloud": "to-cloud";
+            "from-cloud": "from-cloud";
+        }>>;
+        conflictResolution: z.ZodDefault<z.ZodEnum<{
+            custom: "custom";
+            timestamp: "timestamp";
+            "server-wins": "server-wins";
+            "client-wins": "client-wins";
+        }>>;
+        conflictResolver: z.ZodOptional<z.ZodUnknown>;
+        interval: z.ZodDefault<z.ZodNumber>;
+        excludeTables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    backup: z.ZodDefault<z.ZodBoolean>;
+    backupConfig: z.ZodOptional<z.ZodObject<{
+        interval: z.ZodDefault<z.ZodNumber>;
+        maxBackups: z.ZodDefault<z.ZodNumber>;
+        location: z.ZodOptional<z.ZodString>;
+        excludeTables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    internal: z.ZodDefault<z.ZodBoolean>;
+    namespace: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    author: z.ZodOptional<z.ZodString>;
+    versionHistoryUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StorageTableDefinition = z.infer<typeof StorageTableDefinitionSchema>;
+export type MigrationSource = z.infer<typeof MigrationSourceSchema>;
+export type StorageSchemaDescriptor = z.infer<typeof StorageSchemaDescriptorSchema>;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/schemas/schema/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../src/schemas/schema/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAU5B;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuEvC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;+CAOhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwIxC,CAAC;AAIH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/schemas/schema/descriptor.js

@@ -0,0 +1,205 @@
+/**
+ * Storage Schema Descriptor Schema
+ *
+ * Defines a multi-table schema with relations for complex modules.
+ * Used for modules that need multiple related tables with foreign keys.
+ *
+ * @example
+ * ```typescript
+ * const sessionSchemaDescriptor: StorageSchemaDescriptor = {
+ *   kind: 'storage/schema',
+ *   id: 'session',
+ *   name: 'Session Storage Schema',
+ *   description: 'Complete session storage with multiple related tables',
+ *   tables: {
+ *     sessions: {
+ *       schema: SessionSchema,
+ *       primaryKey: 'id',
+ *       indexes: [{ fields: ['status'] }]
+ *     },
+ *     todos: {
+ *       schema: TodoSchema,
+ *       primaryKey: 'id',
+ *       relations: {
+ *         session: { type: 'belongs_to', target: 'sessions', foreignKey: 'sessionId' }
+ *       }
+ *     }
+ *   },
+ *   migrations: () => import('./migrations').then(m => m.SESSION_MIGRATIONS),
+ *   allowedAdapters: ['storage.localdb'],
+ *   dbName: 'sessions.db'
+ * };
+ * ```
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/runtime/schemas/descriptor';
+import { StorageScopeSchema } from '../manifest-descriptor.js';
+import { StorageRelationSchema, StorageIndexSchema, StorageMigrationSchema, StorageFieldConfigSchema } from '../record/descriptor.js';
+/**
+ * Table definition within a schema
+ */
+export const StorageTableDefinitionSchema = z.object({
+    /** Zod schema for the table data (stored as unknown, validated at runtime) */
+    schema: z.unknown(),
+    /** Primary key field name (default: 'id') */
+    primaryKey: z.string().default('id'),
+    /** Relations to other tables in this schema */
+    relations: z.record(z.string(), StorageRelationSchema).optional(),
+    /** Database indexes for this table */
+    indexes: z.array(StorageIndexSchema).default([]),
+    /** Auto-manage timestamps (createdAt, updatedAt) */
+    timestamps: z
+        .union([
+        z.boolean(),
+        z.object({
+            createdAt: z.union([z.boolean(), z.string()]).optional(),
+            updatedAt: z.union([z.boolean(), z.string()]).optional()
+        })
+    ])
+        .default(true),
+    /** Auto-generate IDs */
+    autoId: z
+        .union([
+        z.boolean(),
+        z.object({
+            field: z.string().optional(),
+            strategy: z.enum(['uuid', 'nanoid', 'custom']).optional(),
+            generator: z.optional(z.unknown())
+        })
+    ])
+        .default(true),
+    /** Soft delete field (e.g., 'deletedAt') */
+    softDelete: z.union([z.boolean(), z.string()]).optional(),
+    /** Field-specific configurations */
+    fieldConfig: z.record(z.string(), StorageFieldConfigSchema).optional(),
+    /** Enable record versioning for optimistic locking */
+    versioning: z.boolean().default(false),
+    /** Enable audit trail (createdBy, updatedBy) */
+    audit: z.boolean().default(false),
+    /** Enable change tracking for sync */
+    changeTracking: z.boolean().default(false),
+    /** Custom validation function */
+    validate: z.optional(z.unknown()),
+    /** Before create hook */
+    beforeCreate: z.optional(z.unknown()),
+    /** After create hook */
+    afterCreate: z.optional(z.unknown()),
+    /** Before update hook */
+    beforeUpdate: z.optional(z.unknown()),
+    /** After update hook */
+    afterUpdate: z.optional(z.unknown()),
+    /** Before delete hook */
+    beforeDelete: z.optional(z.unknown()),
+    /** After delete hook */
+    afterDelete: z.optional(z.unknown())
+});
+/**
+ * Migration source - can be inline or lazy-loaded
+ */
+export const MigrationSourceSchema = z.union([
+    // Inline migrations array
+    z.array(StorageMigrationSchema),
+    // Lazy-loaded migrations (function that returns promise)
+    z.unknown(),
+    // Module import path
+    z.string()
+]);
+/**
+ * Storage schema descriptor schema
+ */
+export const StorageSchemaDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('storage/schema'),
+    // SCHEMA DEFINITION
+    /** Human-readable name */
+    name: z.string().min(1),
+    /** Human-readable description */
+    description: z.string().optional(),
+    /** Table definitions (key is table name) */
+    tables: z
+        .record(z.string(), StorageTableDefinitionSchema)
+        .refine((tables) => Object.keys(tables).length > 0, {
+        message: 'Schema must have at least one table'
+    }),
+    // MIGRATIONS
+    /** Inline or lazy-loaded migrations for this schema */
+    migrations: MigrationSourceSchema.optional(),
+    /** Migration key for external migrations (e.g., 'session') */
+    migrationKey: z.string().optional(),
+    /** Current schema version (default: 1) */
+    version: z.number().int().positive().default(1),
+    // ADAPTER SELECTION
+    /** Allowed adapter IDs (e.g., ['storage.localdb', 'storage.drizzle']) */
+    allowedAdapters: z.array(z.string()).min(1),
+    /** Default adapter to use when not specified */
+    defaultAdapter: z.string().optional(),
+    /** Adapter-specific configuration */
+    adapterConfig: z.record(z.string(), z.unknown()).optional(),
+    // SCOPE & STORAGE
+    /** Storage scope for path resolution */
+    scope: StorageScopeSchema.default('project'),
+    /** Custom database name (overrides default) */
+    dbName: z.string().optional(),
+    /** Database schema name (for Postgres) */
+    dbSchema: z.string().optional(),
+    /** Custom base path for database */
+    basePath: z.string().optional(),
+    // SCHEMA FEATURES
+    /** Enable foreign key constraints */
+    foreignKeys: z.boolean().default(true),
+    /** Enable cascade delete for relations with cascadeDelete=true */
+    cascadeDelete: z.boolean().default(true),
+    /** Enable transactions for multi-table operations */
+    transactions: z.boolean().default(true),
+    /** Enable database connection pooling */
+    pooling: z.boolean().default(true),
+    /** Pool size (if pooling enabled) */
+    poolSize: z.number().int().positive().default(5),
+    // SYNC & REPLICATION
+    /** Enable sync between runtimes */
+    sync: z.boolean().default(false),
+    /** Sync configuration */
+    syncConfig: z
+        .object({
+        /** Sync direction */
+        direction: z.enum(['bidirectional', 'to-cloud', 'from-cloud']).default('bidirectional'),
+        /** Conflict resolution strategy */
+        conflictResolution: z
+            .enum(['server-wins', 'client-wins', 'timestamp', 'custom'])
+            .default('timestamp'),
+        /** Custom conflict resolver */
+        conflictResolver: z.optional(z.unknown()),
+        /** Sync interval in milliseconds */
+        interval: z.number().int().positive().default(60000),
+        /** Tables to exclude from sync */
+        excludeTables: z.array(z.string()).optional()
+    })
+        .optional(),
+    // BACKUP & RESTORE
+    /** Enable automatic backups */
+    backup: z.boolean().default(false),
+    /** Backup configuration */
+    backupConfig: z
+        .object({
+        /** Backup interval in milliseconds */
+        interval: z.number().int().positive().default(86400000), // 24 hours
+        /** Maximum number of backups to keep */
+        maxBackups: z.number().int().positive().default(7),
+        /** Backup location */
+        location: z.string().optional(),
+        /** Tables to exclude from backup */
+        excludeTables: z.array(z.string()).optional()
+    })
+        .optional(),
+    // METADATA
+    /** Whether this schema is internal (not user-editable) */
+    internal: z.boolean().default(false),
+    /** Schema namespace (e.g., 'session') */
+    namespace: z.string().optional(),
+    /** Tags for categorization */
+    tags: z.array(z.string()).default([]),
+    /** Schema author/maintainer */
+    author: z.string().optional(),
+    /** Schema version history URL */
+    versionHistoryUrl: z.string().optional()
+});
+//# sourceMappingURL=descriptor.js.map

package/dist/schemas/schema/descriptor.js.map

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

package/dist/schemas/schema/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Storage Schema Exports
+ *
+ * Exports all types and schemas for storage/schema descriptors.
+ */
+export { StorageSchemaDescriptorSchema, StorageTableDefinitionSchema, MigrationSourceSchema, type StorageSchemaDescriptor, type StorageTableDefinition, type MigrationSource } from './descriptor';
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schemas/schema/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,MAAM,cAAc,CAAC"}

package/dist/schemas/schema/index.js

@@ -0,0 +1,7 @@
+/**
+ * Storage Schema Exports
+ *
+ * Exports all types and schemas for storage/schema descriptors.
+ */
+export { StorageSchemaDescriptorSchema, StorageTableDefinitionSchema, MigrationSourceSchema } from './descriptor.js';
+//# sourceMappingURL=index.js.map

package/dist/schemas/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/schema/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EAIrB,MAAM,cAAc,CAAC"}

package/dist/schemas/sync-bridge-descriptor.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Storage Sync-Bridge Descriptor Schema
+ *
+ * Declares a bidirectional sync bridge between a runtime kind (local descriptors)
+ * and a cloud CRUD API. Replaces hand-rolled per-module sync services with a
+ * declarative descriptor that the generic sync executor can process.
+ *
+ * The bridge maps local runtime descriptors ↔ remote API records, handling
+ * ID transformation, ownership filtering, secret stripping, and conflict resolution.
+ */
+import * as z from 'zod/v4';
+export declare const SyncDirectionSchema: z.ZodEnum<{
+    bidirectional: "bidirectional";
+    "push-only": "push-only";
+    "pull-only": "pull-only";
+}>;
+export type SyncDirection = z.infer<typeof SyncDirectionSchema>;
+export declare const ConflictStrategySchema: z.ZodEnum<{
+    "local-wins": "local-wins";
+    "remote-wins": "remote-wins";
+    manual: "manual";
+    newest: "newest";
+}>;
+export type ConflictStrategy = z.infer<typeof ConflictStrategySchema>;
+export declare const OwnershipFilterSchema: z.ZodEnum<{
+    all: "all";
+    "user-only": "user-only";
+    "system-only": "system-only";
+}>;
+export type OwnershipFilter = z.infer<typeof OwnershipFilterSchema>;
+/**
+ * Schema for a sync-bridge descriptor.
+ *
+ * Extends RuntimeDescriptor with source/target/sync configuration.
+ */
+export declare const SyncBridgeDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    kind: z.ZodLiteral<"storage/sync-bridge">;
+    source: z.ZodObject<{
+        runtimeKind: z.ZodString;
+        versionField: z.ZodOptional<z.ZodString>;
+        sourceTypeField: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    target: z.ZodObject<{
+        apiPath: z.ZodString;
+        entityPath: z.ZodOptional<z.ZodString>;
+        listField: z.ZodOptional<z.ZodString>;
+        totalField: z.ZodOptional<z.ZodString>;
+        includeDeleted: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    sync: z.ZodDefault<z.ZodObject<{
+        direction: z.ZodDefault<z.ZodEnum<{
+            bidirectional: "bidirectional";
+            "push-only": "push-only";
+            "pull-only": "pull-only";
+        }>>;
+        ownershipFilter: z.ZodDefault<z.ZodEnum<{
+            all: "all";
+            "user-only": "user-only";
+            "system-only": "system-only";
+        }>>;
+        conflictStrategy: z.ZodDefault<z.ZodEnum<{
+            "local-wins": "local-wins";
+            "remote-wins": "remote-wins";
+            manual: "manual";
+            newest: "newest";
+        }>>;
+        sensitiveFields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        idField: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+export type SyncBridgeDescriptor = z.infer<typeof SyncBridgeDescriptorSchema> & {
+    /**
+     * Transform a local runtime descriptor into the shape the API expects.
+     * Called before pushing to cloud.
+     */
+    toRemote?: (descriptor: Record<string, unknown>) => Record<string, unknown>;
+    /**
+     * Transform an API response record into a local runtime descriptor shape.
+     * Called after pulling from cloud.
+     */
+    fromRemote?: (record: Record<string, unknown>) => Record<string, unknown>;
+    /**
+     * Optional: Ensure remote prerequisites exist before pushing an entity.
+     * Useful when the remote API expects related resources (for example, a
+     * knowledge base) to exist before an item can be upserted.
+     */
+    beforePush?: (descriptor: Record<string, unknown>, context: {
+        apiEndpoint: string;
+        apiToken?: string;
+        fetch: (input: string, init?: RequestInit) => Promise<Response>;
+    }) => Promise<void>;
+    deleteRemote?: (descriptor: Record<string, unknown>, context: {
+        apiEndpoint: string;
+        apiToken?: string;
+        fetch: (input: string, init?: RequestInit) => Promise<Response>;
+    }) => Promise<void>;
+    /**
+     * Optional: Custom collection function. Defaults to runtime.query(source.runtimeKind).descriptors()
+     */
+    collect?: () => Promise<Record<string, unknown>[]> | Record<string, unknown>[];
+    /**
+     * Optional: Storage manifest ID for persisting pulled items.
+     * When set, pulled items are merged into this storage manifest (localdb/json).
+     * When omitted, pulled items are only registered with the runtime (descriptor-only bridges).
+     */
+    storageManifestId?: string;
+    /**
+     * Optional: Custom write function for pulled items.
+     * Called when a remote-only item needs to be persisted locally.
+     * When omitted and storageManifestId is set, uses StorageManifest.load/save.
+     */
+    writePulled?: (items: Record<string, unknown>[]) => Promise<void>;
+};
+//# sourceMappingURL=sync-bridge-descriptor.d.ts.map

package/dist/schemas/sync-bridge-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-bridge-descriptor.d.ts","sourceRoot":"","sources":["../../src/schemas/sync-bridge-descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,mBAAmB;;;;EAAsD,CAAC;AACvF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,sBAAsB;;;;;EAA4D,CAAC;AAChG,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;EAA8C,CAAC;AACjF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0DvB,CAAC;AAEjB,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,GAAG;IAC/E;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5E;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1E;;;;OAIG;IACH,UAAU,CAAC,EAAE,CACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;KAChE,KACG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnB,YAAY,CAAC,EAAE,CACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;KAChE,KACG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAE/E;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE,CAAC"}