@objectstack/spec 0.3.2 → 0.3.3

package/dist/data/field.zod.d.ts.map

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

package/dist/data/field.zod.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Field = exports.FieldSchema = exports.AddressSchema = exports.LocationCoordinatesSchema = exports.SelectOptionSchema = exports.FieldType = void 0;
+exports.Field = exports.FieldSchema = exports.AddressSchema = exports.CurrencyValueSchema = exports.CurrencyConfigSchema = exports.LocationCoordinatesSchema = exports.SelectOptionSchema = exports.FieldType = void 0;
 const zod_1 = require("zod");
 /**
  * Field Type Enum
@@ -54,6 +54,32 @@ exports.LocationCoordinatesSchema = zod_1.z.object({
     altitude: zod_1.z.number().optional().describe('Altitude in meters'),
     accuracy: zod_1.z.number().optional().describe('Accuracy in meters'),
 });
+/**
+ * Currency Configuration Schema
+ * Configuration for currency field type supporting multi-currency
+ *
+ * Note: Currency codes are validated by length only (3 characters) to support:
+ * - Standard ISO 4217 codes (USD, EUR, CNY, etc.)
+ * - Cryptocurrency codes (BTC, ETH, etc.)
+ * - Custom business-specific codes
+ * Stricter validation can be implemented at the application layer based on business requirements.
+ */
+exports.CurrencyConfigSchema = zod_1.z.object({
+    precision: zod_1.z.number().int().min(0).max(10).default(2).describe('Decimal precision (default: 2)'),
+    currencyMode: zod_1.z.enum(['dynamic', 'fixed']).default('dynamic').describe('Currency mode: dynamic (user selectable) or fixed (single currency)'),
+    defaultCurrency: zod_1.z.string().length(3).default('CNY').describe('Default or fixed currency code (ISO 4217, e.g., USD, CNY, EUR)'),
+});
+/**
+ * Currency Value Schema
+ * Runtime value structure for currency fields
+ *
+ * Note: Currency codes are validated by length only (3 characters) to support flexibility.
+ * See CurrencyConfigSchema for details on currency code validation strategy.
+ */
+exports.CurrencyValueSchema = zod_1.z.object({
+    value: zod_1.z.number().describe('Monetary amount'),
+    currency: zod_1.z.string().length(3).describe('Currency code (ISO 4217)'),
+});
 /**
  * Address Schema
  * Structured address for address field type
@@ -134,6 +160,8 @@ exports.FieldSchema = zod_1.z.object({
     qrErrorCorrection: zod_1.z.enum(['L', 'M', 'Q', 'H']).optional().describe('QR code error correction level (L=7%, M=15%, Q=25%, H=30%). Only applicable when barcodeFormat is "qr"'),
     displayValue: zod_1.z.boolean().optional().describe('Display human-readable value below barcode/QR code'),
     allowScanning: zod_1.z.boolean().optional().describe('Enable camera scanning for barcode/QR code input'),
+    // Currency field config
+    currencyConfig: exports.CurrencyConfigSchema.optional().describe('Configuration for currency field type'),
     /** Security & Visibility */
     hidden: zod_1.z.boolean().default(false).describe('Hidden from default UI'),
     readonly: zod_1.z.boolean().default(false).describe('Read-only in UI'),

package/dist/data/filter.zod.d.ts

@@ -20,6 +20,23 @@ import { z } from 'zod';
  * 3. Type Safe: Structure can be statically inferred by TypeScript
  * 4. Convention over Configuration: Implicit syntax for common queries
  */
+/**
+ * Field Reference
+ * Represents a reference to another field/column instead of a literal value.
+ * Used for joins (ON clause) and cross-field comparisons.
+ *
+ * @example
+ * // user.id = order.owner_id
+ * { "$eq": { "$field": "order.owner_id" } }
+ */
+export declare const FieldReferenceSchema: z.ZodObject<{
+    $field: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    $field: string;
+}, {
+    $field: string;
+}>;
+export type FieldReference = z.infer<typeof FieldReferenceSchema>;
 /**
  * Comparison operators for equality and inequality checks.
  * Supported data types: Any
@@ -42,23 +59,63 @@ export declare const EqualityOperatorSchema: z.ZodObject<{
  */
 export declare const ComparisonOperatorSchema: z.ZodObject<{
     /** Greater than - SQL: > | MongoDB: $gt */
-    $gt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $gt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
     /** Greater than or equal to - SQL: >= | MongoDB: $gte */
-    $gte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $gte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
     /** Less than - SQL: < | MongoDB: $lt */
-    $lt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $lt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
     /** Less than or equal to - SQL: <= | MongoDB: $lte */
-    $lte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $lte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
 }, "strip", z.ZodTypeAny, {
-    $gt?: number | Date | undefined;
-    $gte?: number | Date | undefined;
-    $lt?: number | Date | undefined;
-    $lte?: number | Date | undefined;
+    $gt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $gte?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lte?: number | Date | {
+        $field: string;
+    } | undefined;
 }, {
-    $gt?: number | Date | undefined;
-    $gte?: number | Date | undefined;
-    $lt?: number | Date | undefined;
-    $lte?: number | Date | undefined;
+    $gt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $gte?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lte?: number | Date | {
+        $field: string;
+    } | undefined;
 }>;
 /**
  * Set operators for membership checks.
@@ -81,11 +138,31 @@ export declare const SetOperatorSchema: z.ZodObject<{
  */
 export declare const RangeOperatorSchema: z.ZodObject<{
     /** Between (inclusive) - takes [min, max] array */
-    $between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<[z.ZodNumber, z.ZodDate]>, z.ZodUnion<[z.ZodNumber, z.ZodDate]>], null>>;
+    $between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>, z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>], null>>;
 }, "strip", z.ZodTypeAny, {
-    $between?: [number | Date, number | Date] | undefined;
+    $between?: [number | Date | {
+        $field: string;
+    }, number | Date | {
+        $field: string;
+    }] | undefined;
 }, {
-    $between?: [number | Date, number | Date] | undefined;
+    $between?: [number | Date | {
+        $field: string;
+    }, number | Date | {
+        $field: string;
+    }] | undefined;
 }>;
 /**
  * String pattern matching operators.
@@ -129,13 +206,49 @@ export declare const SpecialOperatorSchema: z.ZodObject<{
 export declare const FieldOperatorsSchema: z.ZodObject<{
     $eq: z.ZodOptional<z.ZodAny>;
     $ne: z.ZodOptional<z.ZodAny>;
-    $gt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
-    $gte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
-    $lt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
-    $lte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $gt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
+    $gte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
+    $lt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
+    $lte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
     $in: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
     $nin: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
-    $between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<[z.ZodNumber, z.ZodDate]>, z.ZodUnion<[z.ZodNumber, z.ZodDate]>], null>>;
+    $between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>, z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>], null>>;
     $contains: z.ZodOptional<z.ZodString>;
     $startsWith: z.ZodOptional<z.ZodString>;
     $endsWith: z.ZodOptional<z.ZodString>;
@@ -144,13 +257,25 @@ export declare const FieldOperatorsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     $eq?: any;
     $ne?: any;
-    $gt?: number | Date | undefined;
-    $gte?: number | Date | undefined;
-    $lt?: number | Date | undefined;
-    $lte?: number | Date | undefined;
+    $gt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $gte?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lte?: number | Date | {
+        $field: string;
+    } | undefined;
     $in?: any[] | undefined;
     $nin?: any[] | undefined;
-    $between?: [number | Date, number | Date] | undefined;
+    $between?: [number | Date | {
+        $field: string;
+    }, number | Date | {
+        $field: string;
+    }] | undefined;
     $contains?: string | undefined;
     $startsWith?: string | undefined;
     $endsWith?: string | undefined;
@@ -159,13 +284,25 @@ export declare const FieldOperatorsSchema: z.ZodObject<{
 }, {
     $eq?: any;
     $ne?: any;
-    $gt?: number | Date | undefined;
-    $gte?: number | Date | undefined;
-    $lt?: number | Date | undefined;
-    $lte?: number | Date | undefined;
+    $gt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $gte?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lte?: number | Date | {
+        $field: string;
+    } | undefined;
     $in?: any[] | undefined;
     $nin?: any[] | undefined;
-    $between?: [number | Date, number | Date] | undefined;
+    $between?: [number | Date | {
+        $field: string;
+    }, number | Date | {
+        $field: string;
+    }] | undefined;
     $contains?: string | undefined;
     $startsWith?: string | undefined;
     $endsWith?: string | undefined;

package/dist/data/filter.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.zod.d.ts","sourceRoot":"","sources":["../../src/data/filter.zod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filter.zod.d.ts","sourceRoot":"","sources":["../../src/data/filter.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IACjC,iDAAiD;;IAGjD,kDAAkD;;;;;;;;EAElD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;IACnC,2CAA2C;;;;;;;;IAG3C,yDAAyD;;;;;;;;IAGzD,wCAAwC;;;;;;;;IAGxC,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtD,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,iDAAiD;;IAGjD,sDAAsD;;;;;;;;EAEtD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;EAKnD,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B,2DAA2D;;IAG3D,0DAA0D;;IAG1D,wDAAwD;;;;;;;;;;EAExD,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,uFAAuF;;IAGvF,kEAAkE;;;;;;;;EAElE,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2B/B,CAAC;AAMH;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,GAAG,EAAE,MAAM,GACR,GAAG,GACH,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GACpC,eAAe,CAAC;CACrB,GAAG;IACF,8DAA8D;IAC9D,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;IAEzB,uDAAuD;IACvD,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;IAExB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAQ5D,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAMH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,GAAG,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EACX,CAAC,CAAC,CAAC,CAAC,GACJ;QACE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACX,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACX,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAChD,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACjD,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAChD,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACjD,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACb,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACd,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAC7D,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;QACjD,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;QACnD,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;QACjD,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GACD,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;CACjD,GAAG;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;AAG7D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAuBjD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,8IAWnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,kCAAmC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,aAAa,qKAAuD,CAAC;AAElF,MAAM,MAAM,iBAAiB,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC"}

package/dist/data/filter.zod.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALL_OPERATORS = exports.LOGICAL_OPERATORS = exports.FILTER_OPERATORS = exports.NormalizedFilterSchema = exports.QueryFilterSchema = exports.FilterConditionSchema = exports.FieldOperatorsSchema = exports.SpecialOperatorSchema = exports.StringOperatorSchema = exports.RangeOperatorSchema = exports.SetOperatorSchema = exports.ComparisonOperatorSchema = exports.EqualityOperatorSchema = void 0;
+exports.ALL_OPERATORS = exports.LOGICAL_OPERATORS = exports.FILTER_OPERATORS = exports.NormalizedFilterSchema = exports.QueryFilterSchema = exports.FilterConditionSchema = exports.FieldOperatorsSchema = exports.SpecialOperatorSchema = exports.StringOperatorSchema = exports.RangeOperatorSchema = exports.SetOperatorSchema = exports.ComparisonOperatorSchema = exports.EqualityOperatorSchema = exports.FieldReferenceSchema = void 0;
 const zod_1 = require("zod");
 /**
  * Unified Query DSL Specification
@@ -23,6 +23,18 @@ const zod_1 = require("zod");
  * 3. Type Safe: Structure can be statically inferred by TypeScript
  * 4. Convention over Configuration: Implicit syntax for common queries
  */
+/**
+ * Field Reference
+ * Represents a reference to another field/column instead of a literal value.
+ * Used for joins (ON clause) and cross-field comparisons.
+ *
+ * @example
+ * // user.id = order.owner_id
+ * { "$eq": { "$field": "order.owner_id" } }
+ */
+exports.FieldReferenceSchema = zod_1.z.object({
+    $field: zod_1.z.string().describe('Field Reference/Column Name')
+});
 // ============================================================================
 // 3.1 Comparison Operators
 // ============================================================================
@@ -42,13 +54,13 @@ exports.EqualityOperatorSchema = zod_1.z.object({
  */
 exports.ComparisonOperatorSchema = zod_1.z.object({
     /** Greater than - SQL: > | MongoDB: $gt */
-    $gt: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $gt: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
     /** Greater than or equal to - SQL: >= | MongoDB: $gte */
-    $gte: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $gte: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
     /** Less than - SQL: < | MongoDB: $lt */
-    $lt: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $lt: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
     /** Less than or equal to - SQL: <= | MongoDB: $lte */
-    $lte: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $lte: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
 });
 // ============================================================================
 // 3.2 Set & Range Operators
@@ -69,8 +81,8 @@ exports.SetOperatorSchema = zod_1.z.object({
 exports.RangeOperatorSchema = zod_1.z.object({
     /** Between (inclusive) - takes [min, max] array */
     $between: zod_1.z.tuple([
-        zod_1.z.union([zod_1.z.number(), zod_1.z.date()]),
-        zod_1.z.union([zod_1.z.number(), zod_1.z.date()])
+        zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]),
+        zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema])
     ]).optional(),
 });
 // ============================================================================
@@ -112,16 +124,16 @@ exports.FieldOperatorsSchema = zod_1.z.object({
     $eq: zod_1.z.any().optional(),
     $ne: zod_1.z.any().optional(),
     // Comparison (numeric/date)
-    $gt: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
-    $gte: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
-    $lt: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
-    $lte: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $gt: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
+    $gte: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
+    $lt: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
+    $lte: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
     // Set & Range
     $in: zod_1.z.array(zod_1.z.any()).optional(),
     $nin: zod_1.z.array(zod_1.z.any()).optional(),
     $between: zod_1.z.tuple([
-        zod_1.z.union([zod_1.z.number(), zod_1.z.date()]),
-        zod_1.z.union([zod_1.z.number(), zod_1.z.date()])
+        zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]),
+        zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema])
     ]).optional(),
     // String-specific
     $contains: zod_1.z.string().optional(),

package/dist/data/hook.zod.d.ts

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+/**
+ * Hook Lifecycle Events
+ * Defines the interception points in the ObjectQL execution pipeline.
+ */
+export declare const HookEvent: z.ZodEnum<["beforeFind", "afterFind", "beforeFindOne", "afterFindOne", "beforeCount", "afterCount", "beforeAggregate", "afterAggregate", "beforeInsert", "afterInsert", "beforeUpdate", "afterUpdate", "beforeDelete", "afterDelete", "beforeUpdateMany", "afterUpdateMany", "beforeDeleteMany", "afterDeleteMany"]>;
+/**
+ * Hook Definition Schema
+ *
+ * Hooks serve as the "Logic Layer" in ObjectStack, allowing developers to
+ * inject custom code during the data access lifecycle.
+ *
+ * Use cases:
+ * - Data Enrichment (Default values, Calculated fields)
+ * - Validation (Complex business rules)
+ * - Side Effects (Sending emails, Syncing to external systems)
+ * - Security (Filtering data based on context)
+ */
+export declare const HookSchema: z.ZodObject<{
+    /**
+     * Unique identifier for the hook
+     * Required for debugging and overriding.
+     */
+    name: z.ZodString;
+    /**
+     * Human readable label
+     */
+    label: z.ZodOptional<z.ZodString>;
+    /**
+     * Target Object(s)
+     * can be:
+     * - Single object: "account"
+     * - List of objects: ["account", "contact"]
+     * - Wildcard: "*" (All objects)
+     */
+    object: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    /**
+     * Events to subscribe to
+     * Combinations of timing (before/after) and action (find/insert/update/delete/etc)
+     */
+    events: z.ZodArray<z.ZodEnum<["beforeFind", "afterFind", "beforeFindOne", "afterFindOne", "beforeCount", "afterCount", "beforeAggregate", "afterAggregate", "beforeInsert", "afterInsert", "beforeUpdate", "afterUpdate", "beforeDelete", "afterDelete", "beforeUpdateMany", "afterUpdateMany", "beforeDeleteMany", "afterDeleteMany"]>, "many">;
+    /**
+     * Handler Logic
+     * Reference to a registered function in the plugin system OR a direct function (runtime only).
+     */
+    handler: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodAny]>>;
+    /**
+     * Execution Order
+     * Lower numbers run first.
+     * - System Hooks: 0-99
+     * - App Hooks: 100-999
+     * - User Hooks: 1000+
+     */
+    priority: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Async / Background Execution
+     * If true, the hook runs in the background and does not block the transaction.
+     * Only applicable for 'after*' events.
+     * Default: false (Blocking)
+     */
+    async: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Error Policy
+     * What to do if the hook throws an exception?
+     * - abort: Rollback transaction (if blocking)
+     * - log: Log error and continue
+     */
+    onError: z.ZodDefault<z.ZodEnum<["abort", "log"]>>;
+}, "strip", z.ZodTypeAny, {
+    object: string | string[];
+    name: string;
+    events: ("beforeFind" | "afterFind" | "beforeFindOne" | "afterFindOne" | "beforeCount" | "afterCount" | "beforeAggregate" | "afterAggregate" | "beforeInsert" | "afterInsert" | "beforeUpdate" | "afterUpdate" | "beforeDelete" | "afterDelete" | "beforeUpdateMany" | "afterUpdateMany" | "beforeDeleteMany" | "afterDeleteMany")[];
+    async: boolean;
+    priority: number;
+    onError: "abort" | "log";
+    label?: string | undefined;
+    handler?: any;
+}, {
+    object: string | string[];
+    name: string;
+    events: ("beforeFind" | "afterFind" | "beforeFindOne" | "afterFindOne" | "beforeCount" | "afterCount" | "beforeAggregate" | "afterAggregate" | "beforeInsert" | "afterInsert" | "beforeUpdate" | "afterUpdate" | "beforeDelete" | "afterDelete" | "beforeUpdateMany" | "afterUpdateMany" | "beforeDeleteMany" | "afterDeleteMany")[];
+    label?: string | undefined;
+    async?: boolean | undefined;
+    handler?: any;
+    priority?: number | undefined;
+    onError?: "abort" | "log" | undefined;
+}>;
+/**
+ * Hook Runtime Context
+ * Defines what is available to the hook handler during execution.
+ *
+ * Best Practices:
+ * - **Immutability**: `object`, `event`, `id` are immutable.
+ * - **Mutability**: `input` and `result` are mutable to allow transformation.
+ * - **Encapsulation**: `session` isolates auth info; `transaction` ensures atomicity.
+ */
+export declare const HookContextSchema: z.ZodObject<{
+    /** Tracing ID */
+    id: z.ZodOptional<z.ZodString>;
+    /** Target Object Name */
+    object: z.ZodString;
+    /** Current Lifecycle Event */
+    event: z.ZodEnum<["beforeFind", "afterFind", "beforeFindOne", "afterFindOne", "beforeCount", "afterCount", "beforeAggregate", "afterAggregate", "beforeInsert", "afterInsert", "beforeUpdate", "afterUpdate", "beforeDelete", "afterDelete", "beforeUpdateMany", "afterUpdateMany", "beforeDeleteMany", "afterDeleteMany"]>;
+    /**
+     * Input Parameters (Mutable)
+     * Modify this to change the behavior of the operation.
+     *
+     * - find: { query: QueryAST, options: DriverOptions }
+     * - insert: { doc: Record, options: DriverOptions }
+     * - update: { id: ID, doc: Record, options: DriverOptions }
+     * - delete: { id: ID, options: DriverOptions }
+     * - updateMany: { query: QueryAST, doc: Record, options: DriverOptions }
+     * - deleteMany: { query: QueryAST, options: DriverOptions }
+     */
+    input: z.ZodRecord<z.ZodString, z.ZodAny>;
+    /**
+     * Operation Result (Mutable)
+     * Available in 'after*' events. Modify this to transform the output.
+     */
+    result: z.ZodOptional<z.ZodAny>;
+    /**
+     * Data Snapshot
+     * The state of the record BEFORE the operation (for update/delete).
+     */
+    previous: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Execution Session
+     * Contains authentication and tenancy information.
+     */
+    session: z.ZodOptional<z.ZodObject<{
+        userId: z.ZodOptional<z.ZodString>;
+        tenantId: z.ZodOptional<z.ZodString>;
+        roles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        accessToken: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userId?: string | undefined;
+        tenantId?: string | undefined;
+        roles?: string[] | undefined;
+        accessToken?: string | undefined;
+    }, {
+        userId?: string | undefined;
+        tenantId?: string | undefined;
+        roles?: string[] | undefined;
+        accessToken?: string | undefined;
+    }>>;
+    /**
+     * Transaction Handle
+     * If the operation is part of a transaction, use this handle for side-effects.
+     */
+    transaction: z.ZodOptional<z.ZodAny>;
+    /**
+     * Engine Access
+     * Reference to the ObjectQL engine for performing side effects.
+     */
+    ql: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    event: "beforeFind" | "afterFind" | "beforeFindOne" | "afterFindOne" | "beforeCount" | "afterCount" | "beforeAggregate" | "afterAggregate" | "beforeInsert" | "afterInsert" | "beforeUpdate" | "afterUpdate" | "beforeDelete" | "afterDelete" | "beforeUpdateMany" | "afterUpdateMany" | "beforeDeleteMany" | "afterDeleteMany";
+    input: Record<string, any>;
+    id?: string | undefined;
+    result?: any;
+    previous?: Record<string, any> | undefined;
+    session?: {
+        userId?: string | undefined;
+        tenantId?: string | undefined;
+        roles?: string[] | undefined;
+        accessToken?: string | undefined;
+    } | undefined;
+    transaction?: any;
+    ql?: any;
+}, {
+    object: string;
+    event: "beforeFind" | "afterFind" | "beforeFindOne" | "afterFindOne" | "beforeCount" | "afterCount" | "beforeAggregate" | "afterAggregate" | "beforeInsert" | "afterInsert" | "beforeUpdate" | "afterUpdate" | "beforeDelete" | "afterDelete" | "beforeUpdateMany" | "afterUpdateMany" | "beforeDeleteMany" | "afterDeleteMany";
+    input: Record<string, any>;
+    id?: string | undefined;
+    result?: any;
+    previous?: Record<string, any> | undefined;
+    session?: {
+        userId?: string | undefined;
+        tenantId?: string | undefined;
+        roles?: string[] | undefined;
+        accessToken?: string | undefined;
+    } | undefined;
+    transaction?: any;
+    ql?: any;
+}>;
+export type Hook = z.input<typeof HookSchema>;
+export type ResolvedHook = z.output<typeof HookSchema>;
+export type HookEventType = z.infer<typeof HookEvent>;
+export type HookContext = z.infer<typeof HookContextSchema>;
+//# sourceMappingURL=hook.zod.d.ts.map

package/dist/data/hook.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.zod.d.ts","sourceRoot":"","sources":["../../src/data/hook.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,SAAS,sTAepB,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU;IACrB;;;OAGG;;IAGH;;OAEG;;IAGH;;;;;;OAMG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;;OAMG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;IAC5B,iBAAiB;;IAGjB,yBAAyB;;IAGzB,8BAA8B;;IAG9B;;;;;;;;;;OAUG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;IAQH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}