@objectstack/spec 0.6.1 → 0.7.2

package/dist/data/data-engine.zod.d.ts.map

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

package/dist/data/data-engine.zod.js

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataEngineRequestSchema = exports.DataEngineBatchRequestSchema = exports.DataEngineVectorFindRequestSchema = exports.DataEngineExecuteRequestSchema = exports.DataEngineAggregateRequestSchema = exports.DataEngineCountRequestSchema = exports.DataEngineDeleteRequestSchema = exports.DataEngineUpdateRequestSchema = exports.DataEngineInsertRequestSchema = exports.DataEngineFindOneRequestSchema = exports.DataEngineFindRequestSchema = exports.DataEngineContractSchema = exports.DataEngineCountOptionsSchema = exports.DataEngineAggregateOptionsSchema = exports.DataEngineDeleteOptionsSchema = exports.DataEngineUpdateOptionsSchema = exports.DataEngineInsertOptionsSchema = exports.DataEngineQueryOptionsSchema = exports.DataEngineSortSchema = exports.DataEngineFilterSchema = void 0;
+const zod_1 = require("zod");
+const filter_zod_1 = require("./filter.zod");
+const query_zod_1 = require("./query.zod");
+/**
+ * Data Engine Protocol
+ *
+ * Defines the standard interface for data persistence engines in ObjectStack.
+ * This protocol abstracts the underlying storage mechanism (SQL, NoSQL, API, Memory),
+ * allowing the ObjectQL engine to execute standardized CRUD and Aggregation operations
+ * regardless of where the data resides.
+ *
+ * The Data Engine acts as the "Driver" layer in the Hexagonal Architecture.
+ */
+// ==========================================================================
+// 1. Shared Definitions
+// ==========================================================================
+/**
+ * Data Engine Query filter conditions
+ * Supports simple key-value map or complex Logic/Field expressions (DSL)
+ */
+exports.DataEngineFilterSchema = zod_1.z.union([
+    zod_1.z.record(zod_1.z.any()),
+    filter_zod_1.FilterConditionSchema
+]).describe('Data Engine query filter conditions');
+/**
+ * Sort order definition
+ * Supports:
+ * - { name: 'asc' }
+ * - { name: 1 }
+ * - [{ field: 'name', order: 'asc' }]
+ */
+exports.DataEngineSortSchema = zod_1.z.union([
+    zod_1.z.record(zod_1.z.enum(['asc', 'desc'])),
+    zod_1.z.record(zod_1.z.union([zod_1.z.literal(1), zod_1.z.literal(-1)])),
+    zod_1.z.array(query_zod_1.SortNodeSchema)
+]).describe('Sort order definition');
+// ==========================================================================
+// 2. method: FIND
+// ==========================================================================
+exports.DataEngineQueryOptionsSchema = zod_1.z.object({
+    /** Filter conditions (WHERE) */
+    filter: exports.DataEngineFilterSchema.optional(),
+    /** Fields to select (SELECT) */
+    select: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Sort order (ORDER BY) */
+    sort: exports.DataEngineSortSchema.optional(),
+    /** Limit number of results (LIMIT) */
+    limit: zod_1.z.number().int().min(1).optional(),
+    /** Skip number of results (OFFSET) */
+    skip: zod_1.z.number().int().min(0).optional(),
+    /**
+     * Maximum number of results (OData style)
+     * Takes precedence over limit if both specified
+     */
+    top: zod_1.z.number().int().min(1).optional(),
+    /**
+     * Include related records (JOIN/Populate)
+     * List of relationship field names to expand
+     */
+    populate: zod_1.z.array(zod_1.z.string()).optional(),
+}).describe('Query options for IDataEngine.find() operations');
+// ==========================================================================
+// 3. method: INSERT
+// ==========================================================================
+exports.DataEngineInsertOptionsSchema = zod_1.z.object({
+    /**
+     * Return the inserted record(s)?
+     * Some drivers support RETURNING clause for efficiency.
+     * Default: true
+     */
+    returning: zod_1.z.boolean().default(true).optional(),
+}).describe('Options for DataEngine.insert operations');
+// ==========================================================================
+// 4. method: UPDATE
+// ==========================================================================
+exports.DataEngineUpdateOptionsSchema = zod_1.z.object({
+    /** Filter conditions to identify records to update */
+    filter: exports.DataEngineFilterSchema.optional(),
+    /**
+     * Perform an upsert?
+     * If true, insert if not found.
+     */
+    upsert: zod_1.z.boolean().default(false).optional(),
+    /**
+     * Update multiple records?
+     * If false, only the first match is updated.
+     * Default: false
+     */
+    multi: zod_1.z.boolean().default(false).optional(),
+    /**
+     * Return the updated record(s)?
+     * Default: false (returns update count/status)
+     */
+    returning: zod_1.z.boolean().default(false).optional(),
+}).describe('Options for DataEngine.update operations');
+// ==========================================================================
+// 5. method: DELETE
+// ==========================================================================
+exports.DataEngineDeleteOptionsSchema = zod_1.z.object({
+    /** Filter conditions to identify records to delete */
+    filter: exports.DataEngineFilterSchema.optional(),
+    /**
+     * Delete multiple records?
+     * If false, only the first match is deleted.
+     * Default: false
+     */
+    multi: zod_1.z.boolean().default(false).optional(),
+}).describe('Options for DataEngine.delete operations');
+// ==========================================================================
+// 6. method: AGGREGATE
+// ==========================================================================
+exports.DataEngineAggregateOptionsSchema = zod_1.z.object({
+    /** Filter conditions (WHERE) */
+    filter: exports.DataEngineFilterSchema.optional(),
+    /** Group By fields */
+    groupBy: zod_1.z.array(zod_1.z.string()).optional(),
+    /**
+     * Aggregation definitions
+     * e.g. [{ field: 'amount', method: 'sum', alias: 'total' }]
+     */
+    aggregations: zod_1.z.array(zod_1.z.object({
+        field: zod_1.z.string(),
+        method: zod_1.z.enum(['count', 'sum', 'avg', 'min', 'max', 'count_distinct']),
+        alias: zod_1.z.string().optional()
+    })).optional(),
+}).describe('Options for DataEngine.aggregate operations');
+// ==========================================================================
+// 7. method: COUNT
+// ==========================================================================
+exports.DataEngineCountOptionsSchema = zod_1.z.object({
+    /** Filter conditions */
+    filter: exports.DataEngineFilterSchema.optional(),
+}).describe('Options for DataEngine.count operations');
+// ==========================================================================
+// 8. Definition (Contract)
+// ==========================================================================
+exports.DataEngineContractSchema = zod_1.z.object({
+    find: zod_1.z.function()
+        .args(zod_1.z.string(), exports.DataEngineQueryOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.array(zod_1.z.any()))),
+    findOne: zod_1.z.function()
+        .args(zod_1.z.string(), exports.DataEngineQueryOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.any())),
+    insert: zod_1.z.function()
+        .args(zod_1.z.string(), zod_1.z.union([zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.record(zod_1.z.any()))]), exports.DataEngineInsertOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.any())),
+    update: zod_1.z.function()
+        .args(zod_1.z.string(), zod_1.z.record(zod_1.z.any()), exports.DataEngineUpdateOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.any())),
+    delete: zod_1.z.function()
+        .args(zod_1.z.string(), exports.DataEngineDeleteOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.any())),
+    count: zod_1.z.function()
+        .args(zod_1.z.string(), exports.DataEngineCountOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.number())),
+    aggregate: zod_1.z.function()
+        .args(zod_1.z.string(), exports.DataEngineAggregateOptionsSchema)
+        .returns(zod_1.z.promise(zod_1.z.array(zod_1.z.any())))
+}).describe('Standard Data Engine Contract');
+// ==========================================================================
+// 9. Virtualization & RPC Protocol
+// ==========================================================================
+/**
+ * Data Engine RPC Request (Virtual ObjectQL)
+ *
+ * This schema defines the serialized format for executing Data Engine operations
+ * via HTTP, Message Queue, or Plugin boundaries.
+ *
+ * It enables "Virtual Data Engines" where the implementation resides in a
+ * separate microservice or plugin.
+ */
+exports.DataEngineFindRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('find'),
+    object: zod_1.z.string(),
+    query: exports.DataEngineQueryOptionsSchema.optional()
+});
+exports.DataEngineFindOneRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('findOne'),
+    object: zod_1.z.string(),
+    query: exports.DataEngineQueryOptionsSchema.optional()
+});
+exports.DataEngineInsertRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('insert'),
+    object: zod_1.z.string(),
+    data: zod_1.z.union([zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.record(zod_1.z.any()))]),
+    options: exports.DataEngineInsertOptionsSchema.optional()
+});
+exports.DataEngineUpdateRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('update'),
+    object: zod_1.z.string(),
+    data: zod_1.z.record(zod_1.z.any()),
+    id: zod_1.z.any().optional().describe('ID for single update, or use filter in options'),
+    options: exports.DataEngineUpdateOptionsSchema.optional()
+});
+exports.DataEngineDeleteRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('delete'),
+    object: zod_1.z.string(),
+    id: zod_1.z.any().optional().describe('ID for single delete, or use filter in options'),
+    options: exports.DataEngineDeleteOptionsSchema.optional()
+});
+exports.DataEngineCountRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('count'),
+    object: zod_1.z.string(),
+    query: exports.DataEngineCountOptionsSchema.optional()
+});
+exports.DataEngineAggregateRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('aggregate'),
+    object: zod_1.z.string(),
+    query: exports.DataEngineAggregateOptionsSchema
+});
+/**
+ * Data Engine Execute Request (Raw Command)
+ * Execute a raw command/query native to the driver (e.g. SQL, Shell, Remote API).
+ */
+exports.DataEngineExecuteRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('execute'),
+    /** The abstract command (string SQL, or JSON object) */
+    command: zod_1.z.any(),
+    /** Optional options */
+    options: zod_1.z.record(zod_1.z.any()).optional()
+});
+/**
+ * Data Engine Vector Find Request (AI/RAG)
+ * Perform a similarity search using vector embeddings.
+ */
+exports.DataEngineVectorFindRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('vectorFind'),
+    object: zod_1.z.string(),
+    /** The vector embedding to search for */
+    vector: zod_1.z.array(zod_1.z.number()),
+    /** Optional pre-filter (Metadata filtering) */
+    filter: exports.DataEngineFilterSchema.optional(),
+    /** Fields to select */
+    select: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Number of results */
+    limit: zod_1.z.number().int().default(5).optional(),
+    /** Minimum similarity score (0-1) or distance threshold */
+    threshold: zod_1.z.number().optional()
+});
+/**
+ * Data Engine Batch Request
+ * Execute multiple operations in a single transaction/request efficiently.
+ */
+exports.DataEngineBatchRequestSchema = zod_1.z.object({
+    method: zod_1.z.literal('batch'),
+    requests: zod_1.z.array(zod_1.z.discriminatedUnion('method', [
+        exports.DataEngineFindRequestSchema,
+        exports.DataEngineFindOneRequestSchema,
+        exports.DataEngineInsertRequestSchema,
+        exports.DataEngineUpdateRequestSchema,
+        exports.DataEngineDeleteRequestSchema,
+        exports.DataEngineCountRequestSchema,
+        exports.DataEngineAggregateRequestSchema,
+        exports.DataEngineExecuteRequestSchema,
+        exports.DataEngineVectorFindRequestSchema
+    ])),
+    /**
+     * Transaction Mode
+     * - true: All or nothing (Atomic)
+     * - false: Best effort, continue on error
+     */
+    transaction: zod_1.z.boolean().default(true).optional()
+});
+/**
+ * Unified Data Engine Request Union
+ * Use this to validate any incoming "Virtual ObjectQL" request.
+ */
+exports.DataEngineRequestSchema = zod_1.z.discriminatedUnion('method', [
+    exports.DataEngineFindRequestSchema,
+    exports.DataEngineFindOneRequestSchema,
+    exports.DataEngineInsertRequestSchema,
+    exports.DataEngineUpdateRequestSchema,
+    exports.DataEngineDeleteRequestSchema,
+    exports.DataEngineCountRequestSchema,
+    exports.DataEngineAggregateRequestSchema,
+    exports.DataEngineBatchRequestSchema,
+    exports.DataEngineExecuteRequestSchema,
+    exports.DataEngineVectorFindRequestSchema
+]).describe('Virtual ObjectQL Request Protocol');