@vibesdotdev/storage 0.0.1

package/dist/resolver/storage-backed-resolver.js

@@ -0,0 +1,187 @@
+import { StorageManifest } from '../manifest/base.js';
+import { resolveAdapterOrderBySource, resolveScopeForSource, resolveSourceFromAdapter } from '../manifest/source-policy.js';
+export class StorageBackedResolver {
+    context;
+    manifestId;
+    manifestKind;
+    targetKind;
+    constructor(descriptor, context) {
+        this.context = context;
+        this.manifestId = descriptor.manifestId;
+        this.manifestKind = descriptor.manifestKind ?? 'storage/manifest';
+        this.targetKind = descriptor.targetKind;
+    }
+    async fetch(id, options) {
+        const cached = options?.cache?.getDescriptors()?.find((descriptor) => descriptor.id === id);
+        if (cached)
+            return cached;
+        const bridgeConfig = this.getBridgeConfig();
+        if (!bridgeConfig)
+            return null;
+        const items = await this.loadItems(bridgeConfig);
+        if (!items)
+            return null;
+        let resolved = null;
+        for (const sourced of items) {
+            if (bridgeConfig.filter && !bridgeConfig.filter(sourced.item))
+                continue;
+            const descriptor = bridgeConfig.toDescriptor(sourced.item);
+            if (descriptor.id === id) {
+                resolved = this.withRuntimeSource(descriptor, sourced.source);
+            }
+        }
+        if (resolved && options?.cache) {
+            const cacheLimit = options.maxCacheSize ?? 1000;
+            const descriptors = await this.fetchAll({ maxCacheSize: cacheLimit });
+            if (descriptors.length <= cacheLimit)
+                options.cache.setDescriptors(descriptors);
+        }
+        return resolved;
+    }
+    async fetchAll(options) {
+        const cached = options?.cache?.getDescriptors();
+        if (cached)
+            return this.applyLimit(cached, options?.limit);
+        const bridgeConfig = this.getBridgeConfig();
+        if (!bridgeConfig)
+            return [];
+        const items = await this.loadItems(bridgeConfig);
+        if (!items)
+            return [];
+        const descriptorsById = new Map();
+        for (const sourced of items) {
+            if (bridgeConfig.filter && !bridgeConfig.filter(sourced.item))
+                continue;
+            const descriptor = bridgeConfig.toDescriptor(sourced.item);
+            descriptorsById.set(descriptor.id, this.withRuntimeSource(descriptor, sourced.source));
+        }
+        const descriptors = [...descriptorsById.values()];
+        const cacheLimit = options?.maxCacheSize ?? 1000;
+        if (options?.cache && descriptors.length <= cacheLimit) {
+            options.cache.setDescriptors(descriptors);
+        }
+        return this.applyLimit(descriptors, options?.limit);
+    }
+    applyLimit(descriptors, limit) {
+        if (!limit || limit < 1)
+            return descriptors;
+        return descriptors.slice(0, limit);
+    }
+    async loadItems(_bridgeConfig) {
+        const manifestDescriptor = this.getManifestDescriptor();
+        if (!manifestDescriptor)
+            return null;
+        const adapterIds = this.getOrderedAdapters(manifestDescriptor);
+        if (adapterIds.length === 0)
+            return null;
+        const sourceData = await Promise.all(adapterIds.map(async (adapterId) => ({
+            source: resolveSourceFromAdapter(adapterId),
+            data: await this.loadFromAdapter(manifestDescriptor, adapterId)
+        })));
+        const items = this.mergeSourcedItems(sourceData);
+        if (items.length === 0)
+            return null;
+        return items;
+    }
+    getManifestDescriptor() {
+        const runtime = this.context.runtime;
+        if (!runtime.hasKind(this.manifestKind))
+            return null;
+        const descriptor = runtime.assets(this.manifestKind).descriptor(this.manifestId);
+        if (!descriptor || typeof descriptor !== 'object')
+            return null;
+        return descriptor;
+    }
+    getOrderedAdapters(descriptor) {
+        return resolveAdapterOrderBySource(Array.isArray(descriptor.allowedAdapters) ? descriptor.allowedAdapters : []);
+    }
+    async loadFromAdapter(descriptor, adapterId) {
+        try {
+            const patched = this.patchDescriptorForAdapter(descriptor, adapterId);
+            const manifest = new StorageManifest(patched, this.context);
+            return await manifest.load();
+        }
+        catch {
+            return null;
+        }
+    }
+    patchDescriptorForAdapter(descriptor, adapterId) {
+        const source = resolveSourceFromAdapter(adapterId);
+        const allowedAdapters = [
+            adapterId,
+            ...(descriptor.allowedAdapters ?? []).filter((id) => id !== adapterId)
+        ];
+        const adapterConfig = { ...descriptor.adapterConfig };
+        if (adapterId === 'storage.json') {
+            const jsonConfig = adapterConfig['storage.json'];
+            if (!jsonConfig || typeof jsonConfig !== 'object') {
+                adapterConfig['storage.json'] = { filename: `${descriptor.namespace}.json` };
+            }
+        }
+        const scopePaths = descriptor.scopePaths ? { ...descriptor.scopePaths } : undefined;
+        if (source === 'project-file' && adapterId === 'storage.json') {
+            const nextScopePaths = scopePaths ?? {};
+            nextScopePaths.project = '{workspace}';
+            nextScopePaths.local = '{workspace}';
+            return {
+                ...descriptor,
+                allowedAdapters,
+                defaultAdapter: adapterId,
+                scope: resolveScopeForSource(source, descriptor.scope),
+                scopePaths: nextScopePaths,
+                adapterConfig
+            };
+        }
+        return {
+            ...descriptor,
+            allowedAdapters,
+            defaultAdapter: adapterId,
+            scope: source ? resolveScopeForSource(source, descriptor.scope) : descriptor.scope,
+            scopePaths,
+            adapterConfig
+        };
+    }
+    mergeSourcedItems(values) {
+        const byId = new Map();
+        const loose = [];
+        for (const entry of values) {
+            if (entry.data === null || entry.data === undefined)
+                continue;
+            for (const item of this.asItems(entry.data)) {
+                if (item && typeof item === 'object' && typeof item.id === 'string') {
+                    const id = item.id;
+                    if (!byId.has(id))
+                        byId.set(id, { item, source: entry.source });
+                    continue;
+                }
+                loose.push({ item, source: entry.source });
+            }
+        }
+        return [...loose, ...byId.values()];
+    }
+    asItems(data) {
+        if (!data)
+            return [];
+        if (Array.isArray(data))
+            return data;
+        if (typeof data === 'object' && data !== null && data.constructor === Object) {
+            return Object.values(data);
+        }
+        return [data];
+    }
+    withRuntimeSource(descriptor, source) {
+        if (!source)
+            return descriptor;
+        return Object.assign({}, descriptor, { runtimeSource: source });
+    }
+    getBridgeConfig() {
+        const runtime = this.context.runtime;
+        if (!runtime.hasKind(this.manifestKind))
+            return null;
+        const manifestDescriptor = runtime.assets(this.manifestKind).descriptor(this.manifestId);
+        if (!manifestDescriptor?.providesRuntimeKinds)
+            return null;
+        return (manifestDescriptor.providesRuntimeKinds[this.targetKind] ?? null);
+    }
+}
+//# sourceMappingURL=storage-backed-resolver.js.map

package/dist/resolver/storage-backed-resolver.js.map

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

package/dist/schemas/adapter-descriptor.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Storage Adapter Descriptor Schema
+ *
+ * Schema for storage/adapter kind descriptors.
+ * Extends base descriptor with storage-specific fields.
+ */
+import * as z from 'zod/v4';
+/**
+ * Storage protocols supported by adapters
+ */
+export declare const StorageProtocolSchema: z.ZodEnum<{
+    document: "document";
+    keyvalue: "keyvalue";
+    repository: "repository";
+    record: "record";
+}>;
+/**
+ * Coarse-grained adapter capabilities surfaced to consumers.
+ *
+ * - `list`   — adapter can enumerate items in a container (document protocol's `list()`).
+ * - `read`   — adapter can read existing items.
+ * - `write`  — adapter can create / update / delete items.
+ * - `browse` — adapter implements `list(driveId, path) → StorageEntry[]` and
+ *              `listDrives() → StorageDrive[]` for foldered cloud-storage browsing
+ *              (SharePoint, OneDrive, Google Drive, etc.). Consumers like the
+ *              AI model-source picker filter on this capability to surface
+ *              browsable backends.
+ */
+export declare const StorageCapabilitySchema: z.ZodEnum<{
+    list: "list";
+    read: "read";
+    write: "write";
+    browse: "browse";
+}>;
+/**
+ * Storage adapter descriptor schema
+ */
+export declare const StorageAdapterDescriptorSchema: 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/adapter">;
+    protocols: z.ZodArray<z.ZodEnum<{
+        document: "document";
+        keyvalue: "keyvalue";
+        repository: "repository";
+        record: "record";
+    }>>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        list: "list";
+        read: "read";
+        write: "write";
+        browse: "browse";
+    }>>>;
+    requiresPairSchema: z.ZodDefault<z.ZodBoolean>;
+    supportsTransactions: z.ZodDefault<z.ZodBoolean>;
+    supportsTTL: z.ZodDefault<z.ZodBoolean>;
+    supportsSearch: z.ZodDefault<z.ZodBoolean>;
+    supportsFTS: z.ZodDefault<z.ZodBoolean>;
+    persistent: z.ZodDefault<z.ZodBoolean>;
+    supportsSubscription: z.ZodDefault<z.ZodBoolean>;
+    supportsHierarchy: z.ZodDefault<z.ZodBoolean>;
+    supportsComputedFields: z.ZodDefault<z.ZodBoolean>;
+    supportsSideEffects: z.ZodDefault<z.ZodBoolean>;
+    supportsRawQueries: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type StorageProtocol = z.infer<typeof StorageProtocolSchema>;
+export type StorageCapability = z.infer<typeof StorageCapabilitySchema>;
+export type StorageAdapterDescriptor = z.infer<typeof StorageAdapterDescriptorSchema>;
+/**
+ * A logical "drive" inside a browsable storage adapter — a top-level
+ * container the consumer picks before drilling into folders.
+ *
+ * For SharePoint: a `site`. For OneDrive: the user's default drive.
+ * For Google Drive (future): a "My Drive" or "Shared Drive" entry.
+ *
+ * Returned by `adapter.listDrives()`.
+ */
+export declare const StorageDriveSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodString;
+}, z.core.$strip>;
+export type StorageDrive = z.infer<typeof StorageDriveSchema>;
+/**
+ * A single entry returned by `adapter.list(driveId, path)` —
+ * a file or directory inside a browsable storage adapter.
+ */
+export declare const StorageEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        file: "file";
+        directory: "directory";
+    }>;
+    sizeBytes: z.ZodOptional<z.ZodNumber>;
+    modifiedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StorageEntry = z.infer<typeof StorageEntrySchema>;
+//# sourceMappingURL=adapter-descriptor.d.ts.map

package/dist/schemas/adapter-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-descriptor.d.ts","sourceRoot":"","sources":["../../src/schemas/adapter-descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;EAA2D,CAAC;AAE9F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;;;;;EAA8C,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CzC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAItF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;iBAU7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAa7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schemas/adapter-descriptor.js

@@ -0,0 +1,101 @@
+/**
+ * Storage Adapter Descriptor Schema
+ *
+ * Schema for storage/adapter kind descriptors.
+ * Extends base descriptor with storage-specific fields.
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/runtime/schemas/descriptor';
+/**
+ * Storage protocols supported by adapters
+ */
+export const StorageProtocolSchema = z.enum(['document', 'keyvalue', 'repository', 'record']);
+/**
+ * Coarse-grained adapter capabilities surfaced to consumers.
+ *
+ * - `list`   — adapter can enumerate items in a container (document protocol's `list()`).
+ * - `read`   — adapter can read existing items.
+ * - `write`  — adapter can create / update / delete items.
+ * - `browse` — adapter implements `list(driveId, path) → StorageEntry[]` and
+ *              `listDrives() → StorageDrive[]` for foldered cloud-storage browsing
+ *              (SharePoint, OneDrive, Google Drive, etc.). Consumers like the
+ *              AI model-source picker filter on this capability to surface
+ *              browsable backends.
+ */
+export const StorageCapabilitySchema = z.enum(['list', 'read', 'write', 'browse']);
+/**
+ * Storage adapter descriptor schema
+ */
+export const StorageAdapterDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('storage/adapter'),
+    /** Storage protocols supported by this adapter */
+    protocols: z.array(StorageProtocolSchema),
+    /**
+     * Coarse-grained capability flags consumed by clients that
+     * want to filter adapters by what they can do. `browse` implies the
+     * adapter implements `list(driveId, path)` + `listDrives()`.
+     */
+    capabilities: z.array(StorageCapabilitySchema).default(['read', 'write']),
+    /** Whether adapter requires pair schema (key + value) for main storage */
+    requiresPairSchema: z.boolean().default(false),
+    /** Whether adapter supports transactions */
+    supportsTransactions: z.boolean().default(false),
+    /** Whether adapter supports TTL (for caches) */
+    supportsTTL: z.boolean().default(false),
+    /** Whether adapter supports full-text search */
+    supportsSearch: z.boolean().default(false),
+    /** Whether adapter supports full-text search (alias for supportsSearch) */
+    supportsFTS: z.boolean().default(false),
+    /** Whether adapter is persistent (survives restarts) */
+    persistent: z.boolean().default(false),
+    /** Whether adapter supports change subscriptions */
+    supportsSubscription: z.boolean().default(false),
+    /** Whether adapter supports hierarchical/recursive queries */
+    supportsHierarchy: z.boolean().default(false),
+    /** Whether adapter supports computed fields (aggregations) */
+    supportsComputedFields: z.boolean().default(false),
+    /** Whether adapter supports cross-table side effects */
+    supportsSideEffects: z.boolean().default(false),
+    /** Whether adapter supports raw SQL queries */
+    supportsRawQueries: z.boolean().default(false)
+});
+// Browse — drive + entry shapes for `browse`-capable adapters
+/**
+ * A logical "drive" inside a browsable storage adapter — a top-level
+ * container the consumer picks before drilling into folders.
+ *
+ * For SharePoint: a `site`. For OneDrive: the user's default drive.
+ * For Google Drive (future): a "My Drive" or "Shared Drive" entry.
+ *
+ * Returned by `adapter.listDrives()`.
+ */
+export const StorageDriveSchema = z.object({
+    /** Stable provider-side identifier for the drive (site id, drive id, etc.). */
+    id: z.string(),
+    /** Human-readable name. */
+    name: z.string(),
+    /**
+     * Provider-specific drive kind. Free-form by design — consumers do
+     * not match on this. Example values: `'site'`, `'drive'`, `'shared'`.
+     */
+    kind: z.string()
+});
+/**
+ * A single entry returned by `adapter.list(driveId, path)` —
+ * a file or directory inside a browsable storage adapter.
+ */
+export const StorageEntrySchema = z.object({
+    /** Stable provider-side identifier (drive item id, blob id, etc.). */
+    id: z.string(),
+    /** Display name (e.g. `Quarterly Report.pdf`). */
+    name: z.string(),
+    /** Path relative to the drive root, including the entry's own name. */
+    path: z.string(),
+    /** File vs directory discriminator. */
+    kind: z.enum(['file', 'directory']),
+    /** Size in bytes when known (directories omit this). */
+    sizeBytes: z.number().int().optional(),
+    /** Last modified timestamp (ISO 8601, when known). */
+    modifiedAt: z.string().optional()
+});
+//# sourceMappingURL=adapter-descriptor.js.map

package/dist/schemas/adapter-descriptor.js.map

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

package/dist/schemas/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storage Schemas
+ *
+ * Export all storage-related schemas and types.
+ */
+export { StorageProtocolSchema, StorageCapabilitySchema, StorageAdapterDescriptorSchema, StorageDriveSchema, StorageEntrySchema } from './adapter-descriptor';
+export type { StorageProtocol, StorageCapability, StorageAdapterDescriptor, StorageDrive, StorageEntry } from './adapter-descriptor';
+export { StorageScopeSchema, StorageDataTypeSchema, StorageCloudApiAdapterConfigSchema, StorageManifestDescriptorSchema, } from './manifest-descriptor';
+export type { StorageScope, StorageDataType, StorageCloudApiAdapterConfig, StorageManifestDescriptor } from './manifest-descriptor';
+export { StorageRecordDescriptorSchema, StorageSyncConfigSchema, StorageRemoteCrudSchema, StorageRemoteConfigSchema, StoragePersistenceModeSchema, StoragePersistencePolicySchema, StorageOwnershipFilterSchema, StorageRelationTypeSchema, StorageRelationSchema, StorageIndexSchema, StorageMigrationSchema, StorageFieldConfigSchema, StorageFtsConfigSchema, StorageComputedFieldSchema, StorageHierarchyConfigSchema, StorageSideEffectOperationSchema, StorageSideEffectSchema, StorageSideEffectsConfigSchema } from './record';
+export type { StorageRecordDescriptor, StorageRecordDescriptorInput, StorageSyncConfig, StorageRemoteCrud, StorageRemoteConfig, StoragePersistenceMode, StoragePersistencePolicy, StorageOwnershipFilter, StorageSyncContext, StorageRecordLocalSyncContext, StorageRecordRemoteSyncContext, StorageRecordSyncHooks, StorageRelationType, StorageRelation, StorageIndex, StorageIndexInput, StorageMigration, StorageMigrationInput, StorageFieldConfig, StorageFieldConfigInput, StorageFtsConfig, StorageFtsConfigInput, StorageComputedField, StorageComputedFieldInput, StorageHierarchyConfig, StorageHierarchyConfigInput, StorageSideEffectOperation, StorageSideEffect, StorageSideEffectInput, StorageSideEffectsConfig, StorageSideEffectsConfigInput } from './record';
+export { StorageSchemaDescriptorSchema, StorageTableDefinitionSchema, MigrationSourceSchema } from './schema';
+export type { StorageSchemaDescriptor, StorageTableDefinition, MigrationSource } from './schema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACX,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,kBAAkB,EAClB,qBAAqB,EACrB,kCAAkC,EAClC,+BAA+B,GAC/B,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACX,YAAY,EACZ,eAAe,EACf,4BAA4B,EAC5B,yBAAyB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACN,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EAChC,uBAAuB,EACvB,8BAA8B,EAC9B,MAAM,UAAU,CAAC;AAElB,YAAY,EACX,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,MAAM,UAAU,CAAC;AAGlB,OAAO,EACN,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,MAAM,UAAU,CAAC;AAElB,YAAY,EACX,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,MAAM,UAAU,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,12 @@
+/**
+ * Storage Schemas
+ *
+ * Export all storage-related schemas and types.
+ */
+export { StorageProtocolSchema, StorageCapabilitySchema, StorageAdapterDescriptorSchema, StorageDriveSchema, StorageEntrySchema } from './adapter-descriptor.js';
+export { StorageScopeSchema, StorageDataTypeSchema, StorageCloudApiAdapterConfigSchema, StorageManifestDescriptorSchema, } from './manifest-descriptor.js';
+// Storage record kind (single table CRUD operations)
+export { StorageRecordDescriptorSchema, StorageSyncConfigSchema, StorageRemoteCrudSchema, StorageRemoteConfigSchema, StoragePersistenceModeSchema, StoragePersistencePolicySchema, StorageOwnershipFilterSchema, StorageRelationTypeSchema, StorageRelationSchema, StorageIndexSchema, StorageMigrationSchema, StorageFieldConfigSchema, StorageFtsConfigSchema, StorageComputedFieldSchema, StorageHierarchyConfigSchema, StorageSideEffectOperationSchema, StorageSideEffectSchema, StorageSideEffectsConfigSchema } from './record';
+// Storage schema kind (multi-table schemas with relations)
+export { StorageSchemaDescriptorSchema, StorageTableDefinitionSchema, MigrationSourceSchema } from './schema';
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EACN,kBAAkB,EAClB,qBAAqB,EACrB,kCAAkC,EAClC,+BAA+B,GAC/B,MAAM,uBAAuB,CAAC;AAS/B,qDAAqD;AACrD,OAAO,EACN,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EAChC,uBAAuB,EACvB,8BAA8B,EAC9B,MAAM,UAAU,CAAC;AAoClB,2DAA2D;AAC3D,OAAO,EACN,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,MAAM,UAAU,CAAC"}

package/dist/schemas/manifest-descriptor.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Storage Manifest Descriptor Schema
+ *
+ * Schema for storage/manifest kind descriptors.
+ * Describes a data type that can be stored.
+ */
+import * as z from 'zod/v4';
+/**
+ * Storage scope for path resolution
+ */
+export declare const StorageScopeSchema: z.ZodEnum<{
+    global: "global";
+    project: "project";
+    local: "local";
+    auto: "auto";
+}>;
+/**
+ * Canonical storage data shape.
+ *
+ * - raw: keyed raw text values
+ * - records: structured row collection with CRUD semantics
+ * - objects: keyed JSON/blob objects or a whole document object
+ */
+export declare const StorageDataTypeSchema: z.ZodEnum<{
+    raw: "raw";
+    records: "records";
+    objects: "objects";
+}>;
+/**
+ * Per-scope path configuration
+ * Allows manifests to customize base paths for each scope
+ */
+export declare const ScopePathConfigSchema: z.ZodOptional<z.ZodObject<{
+    global: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    local: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Adapter-specific configuration
+ * Each adapter can define its own config shape
+ *
+ * Examples:
+ * - storage.drizzle: { tableName: 'ai_models', transforms: { toDb, fromDb } }
+ * - storage.localdb: { tableName: 'ai_models', createTable: 'CREATE TABLE...', dbName: 'custom.db', migrationKey: 'my-migrations' }
+ * - storage.json: { filename: 'ai-models.json' }
+ * - storage.cloud-api: { endpoint: '/api/models', ownerApp: 'ai' }
+ */
+export declare const StorageAdapterConfigSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const StorageCloudApiAdapterConfigSchema: z.ZodObject<{
+    ownerApp: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    apiEndpoint: z.ZodOptional<z.ZodString>;
+    idField: z.ZodDefault<z.ZodString>;
+    transform: z.ZodOptional<z.ZodObject<{
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Storage manifest descriptor schema
+ */
+export declare const StorageManifestDescriptorSchema: 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/manifest">;
+    namespace: z.ZodString;
+    schema: z.ZodUnknown;
+    dataType: z.ZodOptional<z.ZodEnum<{
+        raw: "raw";
+        records: "records";
+        objects: "objects";
+    }>>;
+    idField: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    collectionField: z.ZodOptional<z.ZodString>;
+    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";
+    }>>;
+    scopePaths: z.ZodOptional<z.ZodObject<{
+        global: z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        local: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    sensitiveFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    customTables: z.ZodDefault<z.ZodBoolean>;
+    migrationKey: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodNumber>;
+    internal: z.ZodDefault<z.ZodBoolean>;
+    configManifestId: z.ZodOptional<z.ZodString>;
+    providesRuntimeKinds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type StorageScope = z.infer<typeof StorageScopeSchema>;
+export type StorageDataType = z.infer<typeof StorageDataTypeSchema>;
+export type ScopePathConfig = z.infer<typeof ScopePathConfigSchema>;
+export type StorageCloudApiAdapterConfig = z.infer<typeof StorageCloudApiAdapterConfigSchema>;
+export type StorageManifestDescriptor = z.infer<typeof StorageManifestDescriptorSchema>;
+//# sourceMappingURL=manifest-descriptor.d.ts.map

package/dist/schemas/manifest-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-descriptor.d.ts","sourceRoot":"","sources":["../../src/schemas/manifest-descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;EAAiD,CAAC;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;EAAwC,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;kBAMtB,CAAC;AAEb;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,wCAAoC,CAAC;AAE5E,eAAO,MAAM,kCAAkC;;;;;;;;;iBAgB7C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmE1C,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAC9F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}