@vibesdotdev/storage 0.0.1

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

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

package/dist/schemas/record/descriptor.js

@@ -0,0 +1,389 @@
+/**
+ * Storage Record Descriptor Schema
+ *
+ * Defines a record type that provides CRUD operations on a single table.
+ * Used for modules that need structured storage with relations and queries.
+ *
+ * @example
+ * ```typescript
+ * const todoDescriptor: StorageRecordDescriptor = {
+ *   kind: 'storage/record',
+ *   id: 'session.todos',
+ *   name: 'Session Todos',
+ *   description: 'Todo items within sessions',
+ *   schema: TodoSchema,
+ *   tableName: 'todos',
+ *   primaryKey: 'id',
+ *   relations: {
+ *     session: {
+ *       type: 'belongs_to',
+ *       target: 'session.sessions',
+ *       foreignKey: 'sessionId'
+ *     }
+ *   },
+ *   fts: {
+ *     fields: ['content', 'activeForm']
+ *   },
+ *   hierarchy: {
+ *     parentField: 'parentId'
+ *   },
+ *   allowedAdapters: ['storage.localdb'],
+ *   defaultAdapter: 'storage.localdb'
+ * };
+ * ```
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/runtime/schemas/descriptor';
+import { StorageScopeSchema } from '../manifest-descriptor.js';
+import { ConflictStrategySchema } from '../sync-bridge-descriptor.js';
+// RELATION TYPES
+export { StorageRelationSchema, StorageRelationTypeSchema } from './relation.js';
+import { StorageRelationSchema } from './relation.js';
+// INDEX TYPES
+/**
+ * Index definition for a storage record
+ */
+export const StorageIndexSchema = z.object({
+    /** Index name (auto-generated if not provided) */
+    name: z.string().optional(),
+    /** Fields to index */
+    fields: z.array(z.string()).min(1),
+    /** Whether this is a unique index */
+    unique: z.boolean().default(false),
+    /** Custom index type (e.g., 'btree', 'hash') */
+    type: z.string().optional(),
+    /** Index condition (partial index) */
+    where: z.string().optional()
+});
+// MIGRATION TYPES
+/**
+ * Migration definition for storage records
+ */
+export const StorageMigrationSchema = z.object({
+    /** Migration version number */
+    version: z.number().int().positive(),
+    /** Migration name/description */
+    name: z.string().optional(),
+    /** Up migration SQL or function */
+    up: z.union([z.string(), z.unknown()]),
+    /** Down migration SQL or function */
+    down: z.union([z.string(), z.unknown()]).optional()
+});
+// FIELD CONFIG TYPES
+/**
+ * Field configuration for auto-managed fields
+ */
+export const StorageFieldConfigSchema = z.object({
+    /** Enable auto-increment */
+    autoIncrement: z.boolean().optional(),
+    /** Custom ID generator function */
+    generator: z.optional(z.unknown()),
+    /** Field type override */
+    type: z.string().optional(),
+    /** Default value */
+    default: z.unknown().optional()
+});
+// FTS (FULL-TEXT SEARCH) TYPES
+/**
+ * FTS configuration for storage records
+ */
+export const StorageFtsConfigSchema = z.object({
+    /** Fields to index for search */
+    fields: z.array(z.string()).min(1),
+    /** FTS tokenizer (SQLite: 'unicode61', 'porter', etc.) */
+    tokenizer: z.string().optional(),
+    /** Custom FTS table name (default: {tableName}_fts) */
+    tableName: z.string().optional(),
+    /** Additional FTS options */
+    options: z.record(z.string(), z.unknown()).optional()
+});
+// COMPUTED FIELD TYPES
+/**
+ * Computed field definition
+ */
+export const StorageComputedFieldSchema = z.object({
+    /** Aggregation type */
+    type: z.enum(['count', 'sum', 'avg', 'min', 'max', 'exists']),
+    /** Relation to aggregate over */
+    relation: z.string(),
+    /** Field on related table to aggregate (for sum/avg/min/max) */
+    field: z.string().optional(),
+    /** Filter conditions on related records */
+    where: z.record(z.string(), z.unknown()).optional(),
+    /** Custom SQL expression (overrides type/relation) */
+    expression: z.string().optional(),
+    /** Cache the computed value in database */
+    cached: z.boolean().default(false),
+    /** Cache invalidation strategy */
+    cacheStrategy: z.enum(['on_write', 'manual', 'ttl']).optional(),
+    /** Cache TTL in seconds (for ttl strategy) */
+    cacheTtl: z.number().int().positive().optional()
+});
+// HIERARCHY TYPES
+/**
+ * Hierarchy configuration for recursive data
+ */
+export const StorageHierarchyConfigSchema = z.object({
+    /** Field that references parent (e.g., 'parentId') */
+    parentField: z.string(),
+    /** Relation name for children (default: derived from tableName) */
+    childrenRelation: z.string().optional(),
+    /** Include depth in recursive query results */
+    includeDepth: z.boolean().default(true),
+    /** Include path from root in results */
+    includePath: z.boolean().default(false),
+    /** Maximum recursion depth (default: unlimited) */
+    maxDepth: z.number().int().positive().optional()
+});
+// REMOTE ADAPTER CONFIGURATION
+/**
+ * Remote CRUD configuration for cloud sync
+ */
+export const StorageRemoteCrudSchema = z.object({
+    /** Base API path for list operations */
+    apiPath: z.string(),
+    /** API path for single entity operations (:id placeholder) */
+    entityPath: z.string().optional(),
+    /** Remote list response field (defaults to items) */
+    listField: z.string().optional(),
+    /** Remote total response field */
+    totalField: z.string().optional(),
+    /** HTTP method for updates (PUT, PATCH, etc.) */
+    updateMethod: z.enum(['PUT', 'PATCH']).default('PUT'),
+    /** HTTP method for creates (POST, PUT) */
+    createMethod: z.enum(['POST', 'PUT']).default('POST'),
+    /** HTTP method for deletes (DELETE) */
+    deleteMethod: z.literal('DELETE').default('DELETE')
+});
+/**
+ * Remote adapter configuration
+ */
+export const StorageRemoteConfigSchema = z.object({
+    /** Remote adapter ID (typically 'storage.cloud-api') */
+    adapter: z.string().default('storage.cloud-api'),
+    /** CRUD endpoint configuration */
+    crud: StorageRemoteCrudSchema.optional()
+});
+// PERSISTENCE POLICY
+/**
+ * Persistence mode for data storage
+ */
+export const StoragePersistenceModeSchema = z.enum([
+    'local-only', // Store only locally
+    'remote-only', // Store only in cloud
+    'local-first', // Local primary, sync to cloud
+    'remote-first', // Cloud primary, cache locally
+    'auto' // Auto-detect based on connectivity
+]);
+/**
+ * Persistence policy configuration
+ */
+export const StoragePersistencePolicySchema = z.object({
+    /** Persistence mode */
+    mode: StoragePersistenceModeSchema,
+    /** Adapters for local storage */
+    localAdapters: z.array(z.string()).optional(),
+    /** Adapters for remote storage */
+    remoteAdapters: z.array(z.string()).optional()
+});
+// SYNC CONFIGURATION
+/**
+ * Ownership filter for sync operations
+ */
+export const StorageOwnershipFilterSchema = z.enum([
+    'all', // Sync all records
+    'user-only', // Only user-created records
+    'system-only' // Only system records
+]);
+/**
+ * Sync configuration for storage records
+ */
+export const StorageSyncConfigSchema = z.object({
+    /** Ownership filter */
+    ownershipFilter: StorageOwnershipFilterSchema.default('all'),
+    /** Optional field used as canonical ID for sync matching */
+    idField: z.string().optional(),
+    /** Strategy used when both local and remote diverge */
+    conflictStrategy: ConflictStrategySchema.default('local-wins'),
+    /** Fields to strip before pushing to remote */
+    sensitiveFields: z.array(z.string()).default([]),
+    /** Function to collect local items for sync */
+    collect: z.optional(z.unknown()),
+    /** Function to transform local record before sync */
+    toRemote: z.optional(z.unknown()),
+    /** Function to transform remote record into local shape */
+    fromRemote: z.optional(z.unknown()),
+    /** Hook called before pushing to remote */
+    beforePush: z.optional(z.unknown()),
+    /** Hook called to delete remote row */
+    deleteRemote: z.optional(z.unknown()),
+    /** Hook for writing pulled remote rows locally */
+    writePulled: z.optional(z.unknown())
+});
+/**
+ * Side effect operation types
+ */
+export const StorageSideEffectOperationSchema = z.enum([
+    'update', // Update field(s) on target
+    'touch', // Update timestamp field on target
+    'increment', // Increment numeric field
+    'decrement', // Decrement numeric field
+    'refresh' // Refresh computed field
+]);
+/**
+ * Side effect definition
+ */
+export const StorageSideEffectSchema = z.object({
+    /** Target storage record ID */
+    target: z.string(),
+    /** Operation to perform */
+    operation: StorageSideEffectOperationSchema,
+    /** Field to update on target (for update/touch) */
+    field: z.string().optional(),
+    /** Value to set (for update) or expression */
+    value: z.unknown().optional(),
+    /** Value generator function (receives source record) */
+    valueFn: z.optional(z.unknown()),
+    /** Foreign key field to find target record */
+    foreignKey: z.string().optional(),
+    /** Whether to execute in same transaction */
+    sameTransaction: z.boolean().default(true),
+    /** Whether to continue if target not found */
+    ignoreMissing: z.boolean().default(true)
+});
+/**
+ * Side effects configuration by operation
+ */
+export const StorageSideEffectsConfigSchema = z.object({
+    /** Side effects on create */
+    onCreate: z.array(StorageSideEffectSchema).optional(),
+    /** Side effects on update */
+    onUpdate: z.array(StorageSideEffectSchema).optional(),
+    /** Side effects on delete */
+    onDelete: z.array(StorageSideEffectSchema).optional()
+});
+// STORAGE RECORD DESCRIPTOR
+/**
+ * Storage record descriptor schema
+ */
+export const StorageRecordDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('storage/record'),
+    // DATA DEFINITION
+    /** Human-readable name */
+    name: z.string().min(1),
+    /** Human-readable description */
+    description: z.string().optional(),
+    /** Zod schema for the record data (stored as unknown, validated at runtime) */
+    schema: z.unknown(),
+    /** Table name in the database */
+    tableName: z.string().min(1),
+    /** Primary key field name (default: 'id') */
+    primaryKey: z.string().default('id'),
+    // RELATIONS
+    /** Relations to other storage records */
+    relations: z.record(z.string(), StorageRelationSchema).optional(),
+    // INDEXES
+    /** Database indexes for this table */
+    indexes: z.array(StorageIndexSchema).default([]),
+    // FULL-TEXT SEARCH
+    /** Full-text search configuration */
+    fts: StorageFtsConfigSchema.optional(),
+    // COMPUTED FIELDS
+    /** Computed fields from aggregations or relations */
+    computedFields: z.record(z.string(), StorageComputedFieldSchema).optional(),
+    // HIERARCHY (RECURSIVE)
+    /** Hierarchical/recursive configuration */
+    hierarchy: StorageHierarchyConfigSchema.optional(),
+    // SIDE EFFECTS
+    /** Side effects triggered by operations on this record */
+    sideEffects: StorageSideEffectsConfigSchema.optional(),
+    // MIGRATIONS
+    /** Inline migration definitions */
+    migrations: z.array(StorageMigrationSchema).optional(),
+    /** Migration key for external migrations (e.g., 'session.todos') */
+    migrationKey: z.string().optional(),
+    /** Current schema version (default: 1) */
+    version: z.number().int().positive().default(1),
+    // AUTO-MANAGED FIELDS
+    /** 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(),
+    // 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(),
+    // FEATURES
+    /** 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),
+    // VALIDATION
+    /** Custom validation function */
+    validate: z.optional(z.unknown()),
+    /** Enable schema validation on write */
+    validateOnWrite: z.boolean().default(true),
+    /** Enable schema validation on read */
+    validateOnRead: z.boolean().default(false),
+    // HOOKS
+    /** 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()),
+    // METADATA
+    /** Whether this record is internal (not user-editable) */
+    internal: z.boolean().default(false),
+    /** Record namespace (e.g., 'session.todos') */
+    namespace: z.string().optional(),
+    /** Tags for categorization */
+    tags: z.array(z.string()).default([]),
+    // REMOTE & SYNC CONFIGURATION
+    /** Remote adapter configuration for cloud sync */
+    remote: StorageRemoteConfigSchema.optional(),
+    /** Persistence policy for local/remote storage */
+    persistence: StoragePersistencePolicySchema.optional(),
+    /** Sync configuration for bidirectional sync */
+    sync: StorageSyncConfigSchema.optional()
+});
+//# sourceMappingURL=descriptor.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Storage Record Schema Exports
+ *
+ * Exports all types and schemas for storage/record descriptors.
+ */
+export { StorageRecordDescriptorSchema, StorageRelationTypeSchema, StorageRelationSchema, StorageSyncConfigSchema, StorageIndexSchema, StorageMigrationSchema, StorageRemoteCrudSchema, StorageRemoteConfigSchema, StoragePersistenceModeSchema, StoragePersistencePolicySchema, StorageOwnershipFilterSchema, StorageFieldConfigSchema, StorageFtsConfigSchema, StorageComputedFieldSchema, StorageHierarchyConfigSchema, StorageSideEffectOperationSchema, StorageSideEffectSchema, StorageSideEffectsConfigSchema } from './descriptor';
+export type { StorageRecordDescriptor, StorageRecordDescriptorInput, StorageSyncConfig, StorageRemoteCrud, StorageRemoteConfig, StoragePersistenceMode, StoragePersistencePolicy, StorageOwnershipFilter, StorageRelationType, StorageRelation, StorageIndex, StorageIndexInput, StorageMigration, StorageMigrationInput, StorageSyncContext, StorageRecordLocalSyncContext, StorageRecordRemoteSyncContext, StorageRecordSyncHooks, StorageFieldConfig, StorageFieldConfigInput, StorageFtsConfig, StorageFtsConfigInput, StorageComputedField, StorageComputedFieldInput, StorageHierarchyConfig, StorageHierarchyConfigInput, StorageSideEffectOperation, StorageSideEffect, StorageSideEffectInput, StorageSideEffectsConfig, StorageSideEffectsConfigInput } from './descriptor';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schemas/record/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,6BAA6B,EAC7B,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EAChC,uBAAuB,EACvB,8BAA8B,EAC9B,MAAM,cAAc,CAAC;AAEtB,YAAY,EACX,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,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,cAAc,CAAC"}

package/dist/schemas/record/index.js

@@ -0,0 +1,7 @@
+/**
+ * Storage Record Schema Exports
+ *
+ * Exports all types and schemas for storage/record descriptors.
+ */
+export { StorageRecordDescriptorSchema, StorageRelationTypeSchema, StorageRelationSchema, StorageSyncConfigSchema, StorageIndexSchema, StorageMigrationSchema, StorageRemoteCrudSchema, StorageRemoteConfigSchema, StoragePersistenceModeSchema, StoragePersistencePolicySchema, StorageOwnershipFilterSchema, StorageFieldConfigSchema, StorageFtsConfigSchema, StorageComputedFieldSchema, StorageHierarchyConfigSchema, StorageSideEffectOperationSchema, StorageSideEffectSchema, StorageSideEffectsConfigSchema } from './descriptor.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/record/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,6BAA6B,EAC7B,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EAChC,uBAAuB,EACvB,8BAA8B,EAC9B,MAAM,cAAc,CAAC"}

package/dist/schemas/record/relation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Storage record relation schemas / types.
+ *
+ * Extracted from `./descriptor.ts` so the record interface module
+ * (`../../interfaces/record/interface.ts`) can reference `StorageRelation`
+ * without forming a cycle (descriptor.ts itself imports
+ * `StorageRecordInterface` from the interface module for its sync /
+ * remote context types).
+ */
+import * as z from 'zod/v4';
+/** Relation types for storage records. */
+export declare const StorageRelationTypeSchema: z.ZodEnum<{
+    belongs_to: "belongs_to";
+    has_one: "has_one";
+    has_many: "has_many";
+    many_to_many: "many_to_many";
+}>;
+/** Relation definition for a storage record. */
+export declare const StorageRelationSchema: 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>;
+export type StorageRelationType = z.infer<typeof StorageRelationTypeSchema>;
+export type StorageRelation = z.infer<typeof StorageRelationSchema>;
+//# sourceMappingURL=relation.d.ts.map

package/dist/schemas/record/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../../src/schemas/record/relation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB;;;;;EAKpC,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAwBhC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/record/relation.js

@@ -0,0 +1,37 @@
+/**
+ * Storage record relation schemas / types.
+ *
+ * Extracted from `./descriptor.ts` so the record interface module
+ * (`../../interfaces/record/interface.ts`) can reference `StorageRelation`
+ * without forming a cycle (descriptor.ts itself imports
+ * `StorageRecordInterface` from the interface module for its sync /
+ * remote context types).
+ */
+import * as z from 'zod/v4';
+/** Relation types for storage records. */
+export const StorageRelationTypeSchema = z.enum([
+    'belongs_to', // Many-to-one (e.g., todo belongs to session)
+    'has_one', // One-to-one (e.g., session has one config)
+    'has_many', // One-to-many (e.g., session has many todos)
+    'many_to_many' // Many-to-many (e.g., user has many roles)
+]);
+/** Relation definition for a storage record. */
+export const StorageRelationSchema = z.object({
+    /** Relation type */
+    type: StorageRelationTypeSchema,
+    /** Target record descriptor ID (e.g., 'session.sessions') */
+    target: z.string(),
+    /** Foreign key field in this table (for belongs_to) */
+    foreignKey: z.string().optional(),
+    /** Foreign key field in target table (for has_one/has_many) */
+    foreignKeyTarget: z.string().optional(),
+    /** Junction table for many_to_many relations */
+    through: z.string().optional(),
+    /** Whether this relation is optional */
+    optional: z.boolean().default(false),
+    /** Cascade delete when parent is deleted */
+    cascadeDelete: z.boolean().default(false),
+    /** Custom relation name (defaults to property key) */
+    as: z.string().optional()
+});
+//# sourceMappingURL=relation.js.map

package/dist/schemas/record/relation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.js","sourceRoot":"","sources":["../../../src/schemas/record/relation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,0CAA0C;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/C,YAAY,EAAE,8CAA8C;IAC5D,SAAS,EAAE,4CAA4C;IACvD,UAAU,EAAE,6CAA6C;IACzD,cAAc,CAAC,2CAA2C;CAC1D,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,oBAAoB;IACpB,IAAI,EAAE,yBAAyB;IAE/B,6DAA6D;IAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAElB,uDAAuD;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,+DAA+D;IAC/D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEvC,gDAAgD;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE9B,wCAAwC;IACxC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEpC,4CAA4C;IAC5C,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEzC,sDAAsD;IACtD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACzB,CAAC,CAAC"}