@objectstack/spec 0.4.1 → 0.6.0

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

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/**
+ * Data Engine Protocol
+ *
+ * Defines the standard interface for data persistence engines.
+ * This allows different data engines (ObjectQL, Prisma, TypeORM, etc.)
+ * to be used interchangeably through a common interface.
+ *
+ * Following the Dependency Inversion Principle - plugins depend on this interface,
+ * not on concrete database implementations.
+ */
+/**
+ * Data Engine Query filter conditions
+ * Simple key-value filter structure for IDataEngine.find() operations
+ */
+export declare const DataEngineFilterSchema: z.ZodRecord<z.ZodString, z.ZodAny>;
+/**
+ * Query options for IDataEngine.find() operations
+ */
+export declare const DataEngineQueryOptionsSchema: z.ZodObject<{
+    /** Filter conditions */
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /** Fields to select */
+    select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Sort order */
+    sort: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<-1>, z.ZodLiteral<"asc">, z.ZodLiteral<"desc">]>>>;
+    /** Limit number of results (alternative name for top, used by some drivers) */
+    limit: z.ZodOptional<z.ZodNumber>;
+    /** Skip number of results (for pagination) */
+    skip: z.ZodOptional<z.ZodNumber>;
+    /** Maximum number of results (OData-style, takes precedence over limit if both specified) */
+    top: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    sort?: Record<string, 1 | "asc" | "desc" | -1> | undefined;
+    filter?: Record<string, any> | undefined;
+    limit?: number | undefined;
+    select?: string[] | undefined;
+    top?: number | undefined;
+    skip?: number | undefined;
+}, {
+    sort?: Record<string, 1 | "asc" | "desc" | -1> | undefined;
+    filter?: Record<string, any> | undefined;
+    limit?: number | undefined;
+    select?: string[] | undefined;
+    top?: number | undefined;
+    skip?: number | undefined;
+}>;
+/**
+ * Data Engine Interface Schema
+ *
+ * Defines the contract for data engine implementations.
+ * (Deprecated: Moved to @objectstack/core/contracts/data-engine)
+ */
+/**
+ * TypeScript types derived from schemas
+ */
+export type DataEngineFilter = z.infer<typeof DataEngineFilterSchema>;
+export type DataEngineQueryOptions = z.infer<typeof DataEngineQueryOptionsSchema>;
+//# sourceMappingURL=data-engine.zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-engine.zod.d.ts","sourceRoot":"","sources":["../../src/system/data-engine.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,oCAAoE,CAAC;AAExG;;GAEG;AACH,eAAO,MAAM,4BAA4B;IACvC,wBAAwB;;IAExB,uBAAuB;;IAEvB,iBAAiB;;IAEjB,+EAA+E;;IAE/E,8CAA8C;;IAE9C,6FAA6F;;;;;;;;;;;;;;;;EAEjC,CAAC;AAE/D;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataEngineQueryOptionsSchema = exports.DataEngineFilterSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Data Engine Protocol
+ *
+ * Defines the standard interface for data persistence engines.
+ * This allows different data engines (ObjectQL, Prisma, TypeORM, etc.)
+ * to be used interchangeably through a common interface.
+ *
+ * Following the Dependency Inversion Principle - plugins depend on this interface,
+ * not on concrete database implementations.
+ */
+/**
+ * Data Engine Query filter conditions
+ * Simple key-value filter structure for IDataEngine.find() operations
+ */
+exports.DataEngineFilterSchema = zod_1.z.record(zod_1.z.any()).describe('Data Engine query filter conditions');
+/**
+ * Query options for IDataEngine.find() operations
+ */
+exports.DataEngineQueryOptionsSchema = zod_1.z.object({
+    /** Filter conditions */
+    filter: exports.DataEngineFilterSchema.optional(),
+    /** Fields to select */
+    select: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Sort order */
+    sort: zod_1.z.record(zod_1.z.union([zod_1.z.literal(1), zod_1.z.literal(-1), zod_1.z.literal('asc'), zod_1.z.literal('desc')])).optional(),
+    /** Limit number of results (alternative name for top, used by some drivers) */
+    limit: zod_1.z.number().optional(),
+    /** Skip number of results (for pagination) */
+    skip: zod_1.z.number().optional(),
+    /** Maximum number of results (OData-style, takes precedence over limit if both specified) */
+    top: zod_1.z.number().optional(),
+}).describe('Query options for IDataEngine.find() operations');
+// Moved IDataEngine interface to @objectstack/core to separate runtime contract from data schema
+// Moved IDataEngine interface to @objectstack/core to separate runtime contract from data schema

package/dist/system/index.d.ts

@@ -21,4 +21,5 @@ export * from './datasource.zod';
 export * from './driver.zod';
 export * from './driver/mongo.zod';
 export * from './driver/postgres.zod';
+export * from './data-engine.zod';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,mBAAmB,CAAC"}

package/dist/system/index.js

@@ -39,5 +39,7 @@ __exportStar(require("./datasource.zod"), exports);
 __exportStar(require("./driver.zod"), exports);
 __exportStar(require("./driver/mongo.zod"), exports);
 __exportStar(require("./driver/postgres.zod"), exports);
+// Data Engine Protocol
+__exportStar(require("./data-engine.zod"), exports);
 // Note: Auth, Identity, Policy, Role, Organization moved to @objectstack/spec/auth
 // Note: Territory moved to @objectstack/spec/permission

package/dist/system/manifest.zod.d.ts

@@ -17,12 +17,15 @@ export declare const ManifestSchema: z.ZodObject<{
     version: z.ZodString;
     /**
      * Type of the package in the ObjectStack ecosystem.
-     * - app: Standalone application
-     * - plugin: Extension to ObjectOS
-     * - driver: Low-level integration driver
-     * - module: Reusable code module
+     * - app: Business application package
+     * - plugin: General-purpose functionality extension
+     * - driver: Southbound interface - Database/external service adapter (Postgres, MongoDB, S3)
+     * - module: Reusable code library/shared module
+     * - objectql: Core engine - Data layer implementation
+     * - gateway: Northbound interface - API protocol entry point (GraphQL, REST, RPC, OData)
+     * - adapter: Host adapter - Runtime container (Express, Hono, Fastify, Serverless)
      */
-    type: z.ZodEnum<["app", "plugin", "driver", "module"]>;
+    type: z.ZodEnum<["app", "plugin", "driver", "module", "objectql", "gateway", "adapter"]>;
     /**
      * Human-readable name of the package.
      */
@@ -363,7 +366,7 @@ export declare const ManifestSchema: z.ZodObject<{
      */
     extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, "strip", z.ZodTypeAny, {
-    type: "app" | "module" | "plugin" | "driver";
+    type: "app" | "module" | "plugin" | "driver" | "objectql" | "gateway" | "adapter";
     name: string;
     id: string;
     version: string;
@@ -435,7 +438,7 @@ export declare const ManifestSchema: z.ZodObject<{
     } | undefined;
     extensions?: Record<string, any> | undefined;
 }, {
-    type: "app" | "module" | "plugin" | "driver";
+    type: "app" | "module" | "plugin" | "driver" | "objectql" | "gateway" | "adapter";
     name: string;
     id: string;
     version: string;

package/dist/system/manifest.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.zod.d.ts","sourceRoot":"","sources":["../../src/system/manifest.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;;OAMG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaH;;;OAGG;;QAED;;;;WAIG;;;;;;;;;;;;;;QAOH;;;WAGG;;QAGH;;WAEG;;;;;;;;;;;;;;QAOH;;WAEG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;QAMH;;;WAGG;;;;;;;;;;;;;;;;;;;;QASH;;;WAGG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASL;;;OAGG;;;;;;;;;;;;;;IAOH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"manifest.zod.d.ts","sourceRoot":"","sources":["../../src/system/manifest.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;;;;;OASG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaH;;;OAGG;;QAED;;;;WAIG;;;;;;;;;;;;;;QAOH;;;WAGG;;QAGH;;WAEG;;;;;;;;;;;;;;QAOH;;WAEG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;QAMH;;;WAGG;;;;;;;;;;;;;;;;;;;;QASH;;;WAGG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;;;;QAOH;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASL;;;OAGG;;;;;;;;;;;;;;IAOH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/system/manifest.zod.js

@@ -20,12 +20,15 @@ exports.ManifestSchema = zod_1.z.object({
     version: zod_1.z.string().regex(/^\d+\.\d+\.\d+$/).describe('Package version (semantic versioning)'),
     /**
      * Type of the package in the ObjectStack ecosystem.
-     * - app: Standalone application
-     * - plugin: Extension to ObjectOS
-     * - driver: Low-level integration driver
-     * - module: Reusable code module
+     * - app: Business application package
+     * - plugin: General-purpose functionality extension
+     * - driver: Southbound interface - Database/external service adapter (Postgres, MongoDB, S3)
+     * - module: Reusable code library/shared module
+     * - objectql: Core engine - Data layer implementation
+     * - gateway: Northbound interface - API protocol entry point (GraphQL, REST, RPC, OData)
+     * - adapter: Host adapter - Runtime container (Express, Hono, Fastify, Serverless)
      */
-    type: zod_1.z.enum(['app', 'plugin', 'driver', 'module']).describe('Type of package'),
+    type: zod_1.z.enum(['app', 'plugin', 'driver', 'module', 'objectql', 'gateway', 'adapter']).describe('Type of package'),
     /**
      * Human-readable name of the package.
      */