@objectstack/spec 0.3.2 → 0.4.1

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

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

package/dist/system/driver.zod.js

@@ -21,6 +21,16 @@ exports.DriverOptionsSchema = zod_1.z.object({
      * Whether to bypass cache and force a fresh read.
      */
     skipCache: zod_1.z.boolean().optional().describe('Bypass cache'),
+    /**
+     * Distributed Tracing Context.
+     * Used for passing OpenTelemetry span context or request IDs for observability.
+     */
+    traceContext: zod_1.z.record(zod_1.z.string()).optional().describe('OpenTelemetry context or request ID'),
+    /**
+     * Tenant Identifier.
+     * For multi-tenant databases (row-level security or schema-per-tenant).
+     */
+    tenantId: zod_1.z.string().optional().describe('Tenant Isolation identifier'),
 });
 /**
  * Driver Capabilities Schema
@@ -95,6 +105,15 @@ exports.DriverCapabilitiesSchema = zod_1.z.object({
      * If false, arrays will be stored as JSON strings or in separate tables.
      */
     arrayFields: zod_1.z.boolean().describe('Supports array field types'),
+    /**
+     * Whether the driver supports vector embeddings and similarity search.
+     * Required for RAG (Retrieval-Augmented Generation) and AI features.
+     */
+    vectorSearch: zod_1.z.boolean().default(false).describe('Supports vector embeddings and similarity search'),
+    /**
+     * Whether the driver supports geospatial queries.
+     */
+    geoSpatial: zod_1.z.boolean().default(false).describe('Supports geospatial queries'),
 });
 /**
  * Unified Database Driver Interface
@@ -137,6 +156,19 @@ exports.DriverInterfaceSchema = zod_1.z.object({
     checkHealth: zod_1.z.function()
         .returns(zod_1.z.promise(zod_1.z.boolean()))
         .describe('Health check'),
+    /**
+     * Get Connection Pool Statistics.
+     * Useful for monitoring database load.
+     */
+    getPoolStats: zod_1.z.function()
+        .returns(zod_1.z.object({
+        total: zod_1.z.number(),
+        idle: zod_1.z.number(),
+        active: zod_1.z.number(),
+        waiting: zod_1.z.number(),
+    }).optional())
+        .optional()
+        .describe('Get connection pool statistics'),
     // ============================================================================
     // Raw Execution (Escape Hatch)
     // ============================================================================
@@ -185,6 +217,19 @@ exports.DriverInterfaceSchema = zod_1.z.object({
         .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
         .returns(zod_1.z.promise(zod_1.z.array(zod_1.z.record(zod_1.z.any()))))
         .describe('Find records'),
+    /**
+     * Stream records matching the structured query.
+     * Optimized for large datasets to avoid memory overflow.
+     *
+     * @param object - The name of the object.
+     * @param query - The structured QueryAST.
+     * @param options - Driver options.
+     * @returns AsyncIterable/ReadableStream of records.
+     */
+    findStream: zod_1.z.function()
+        .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.any()) // Zod cannot easily represent AsyncIterable<T>
+        .describe('Stream records (AsyncIterable)'),
     /**
      * Find a single record by query.
      * Similar to find(), but returns only the first match or null.
@@ -226,6 +271,19 @@ exports.DriverInterfaceSchema = zod_1.z.object({
         .args(zod_1.z.string(), zod_1.z.string().or(zod_1.z.number()), zod_1.z.record(zod_1.z.any()), exports.DriverOptionsSchema.optional())
         .returns(zod_1.z.promise(zod_1.z.record(zod_1.z.any())))
         .describe('Update record'),
+    /**
+     * Upsert (Update or Insert) a record.
+     *
+     * @param object - The object name.
+     * @param data - The data to upsert.
+     * @param conflictKeys - Fields to check for conflict (uniqueness).
+     * @param options - Driver options.
+     * @returns The created or updated record.
+     */
+    upsert: zod_1.z.function()
+        .args(zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.string()).optional(), exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.record(zod_1.z.any())))
+        .describe('Upsert record'),
     /**
      * Delete a record by ID.
      *
@@ -283,14 +341,43 @@ exports.DriverInterfaceSchema = zod_1.z.object({
     bulkDelete: zod_1.z.function()
         .args(zod_1.z.string(), zod_1.z.array(zod_1.z.string().or(zod_1.z.number())), exports.DriverOptionsSchema.optional())
         .returns(zod_1.z.promise(zod_1.z.void())),
+    /**
+     * Update multiple records matching a query.
+     * Direct database push-down. DOES NOT trigger per-record hooks.
+     *
+     * @param object - The object name.
+     * @param query - The filtering criteria.
+     * @param data - The data to update.
+     * @returns Count of modified records.
+     */
+    updateMany: zod_1.z.function()
+        .args(zod_1.z.string(), query_zod_1.QuerySchema, zod_1.z.record(zod_1.z.any()), exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.number()))
+        .optional(),
+    /**
+     * Delete multiple records matching a query.
+     * Direct database push-down. DOES NOT trigger per-record hooks.
+     *
+     * @param object - The object name.
+     * @param query - The filtering criteria.
+     * @returns Count of deleted records.
+     */
+    deleteMany: zod_1.z.function()
+        .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.number()))
+        .optional(),
     // ============================================================================
     // Transaction Management
     // ============================================================================
     /**
      * Begin a new database transaction.
+     * @param options - Isolation level and other settings.
      * @returns A transaction handle to be passed to subsequent operations via `options.transaction`.
      */
     beginTransaction: zod_1.z.function()
+        .args(zod_1.z.object({
+        isolationLevel: zod_1.z.enum(['READ UNCOMMITTED', 'READ COMMITTED', 'REPEATABLE READ', 'SERIALIZABLE', 'SNAPSHOT']).optional()
+    }).optional())
         .returns(zod_1.z.promise(zod_1.z.any()))
         .describe('Start transaction'),
     /**
@@ -334,4 +421,16 @@ exports.DriverInterfaceSchema = zod_1.z.object({
     dropTable: zod_1.z.function()
         .args(zod_1.z.string(), exports.DriverOptionsSchema.optional())
         .returns(zod_1.z.promise(zod_1.z.void())),
+    /**
+     * Analyze query performance.
+     * Returns execution plan without executing the query (where possible).
+     *
+     * @param object - The object name.
+     * @param query - The query to explain.
+     * @returns The execution plan details.
+     */
+    explain: zod_1.z.function()
+        .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.any()))
+        .optional(),
 });

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

@@ -22,6 +22,9 @@ export declare const EventMetadataSchema: z.ZodObject<{
 /**
  * Event Schema
  * Base schema for all events in the system
+ *
+ * Event names follow dot notation for namespacing (e.g., 'user.created', 'order.paid').
+ * This aligns with industry standards for event-driven architectures and message queues.
  */
 export declare const EventSchema: z.ZodObject<{
     name: z.ZodString;
@@ -110,8 +113,6 @@ export declare const EventHandlerSchema: z.ZodObject<{
     async: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     async: boolean;
-    priority: number;
-    eventName: string;
     handler: (args_0: {
         name: string;
         metadata: {
@@ -122,8 +123,9 @@ export declare const EventHandlerSchema: z.ZodObject<{
         };
         payload?: any;
     }, ...args: unknown[]) => Promise<void>;
-}, {
+    priority: number;
     eventName: string;
+}, {
     handler: (args_0: {
         name: string;
         metadata: {
@@ -134,6 +136,7 @@ export declare const EventHandlerSchema: z.ZodObject<{
         };
         payload?: any;
     }, ...args: unknown[]) => Promise<void>;
+    eventName: string;
     async?: boolean | undefined;
     priority?: number | undefined;
 }>;
@@ -147,12 +150,12 @@ export declare const EventRouteSchema: z.ZodObject<{
     to: z.ZodArray<z.ZodString, "many">;
     transform: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    to: string[];
     from: string;
+    to: string[];
     transform?: ((...args: unknown[]) => unknown) | undefined;
 }, {
-    to: string[];
     from: string;
+    to: string[];
     transform?: ((...args: unknown[]) => unknown) | undefined;
 }>;
 export type EventRoute = z.infer<typeof EventRouteSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"events.zod.d.ts","sourceRoot":"","sources":["../../src/system/events.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAItB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"events.zod.d.ts","sourceRoot":"","sources":["../../src/system/events.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAItB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/system/events.zod.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventPersistenceSchema = exports.EventRouteSchema = exports.EventHandlerSchema = exports.EventSchema = exports.EventMetadataSchema = void 0;
 const zod_1 = require("zod");
+const identifiers_zod_1 = require("../shared/identifiers.zod");
 /**
  * Event Metadata Schema
  * Metadata associated with every event
@@ -15,9 +16,12 @@ exports.EventMetadataSchema = zod_1.z.object({
 /**
  * Event Schema
  * Base schema for all events in the system
+ *
+ * Event names follow dot notation for namespacing (e.g., 'user.created', 'order.paid').
+ * This aligns with industry standards for event-driven architectures and message queues.
  */
 exports.EventSchema = zod_1.z.object({
-    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_.]*$/).describe('Event name (snake_case with dots, e.g., user.created)'),
+    name: identifiers_zod_1.EventNameSchema.describe('Event name (lowercase with dots, e.g., user.created, order.paid)'),
     payload: zod_1.z.any().describe('Event payload schema'),
     metadata: exports.EventMetadataSchema.describe('Event metadata'),
 });

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

@@ -0,0 +1,131 @@
+import { z } from 'zod';
+/**
+ * Feature Rollout Strategy
+ */
+export declare const FeatureStrategy: z.ZodEnum<["boolean", "percentage", "user_list", "group", "custom"]>;
+/**
+ * Feature Flag Protocol
+ *
+ * Manages feature toggles and gradual rollouts.
+ * Used for CI/CD, A/B Testing, and Trunk-Based Development.
+ */
+export declare const FeatureFlagSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    /** Default state */
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    /** Rollout Strategy */
+    strategy: z.ZodDefault<z.ZodEnum<["boolean", "percentage", "user_list", "group", "custom"]>>;
+    /** Strategy Configuration */
+    conditions: z.ZodOptional<z.ZodObject<{
+        percentage: z.ZodOptional<z.ZodNumber>;
+        users: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        groups: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        expression: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        expression?: string | undefined;
+        groups?: string[] | undefined;
+        percentage?: number | undefined;
+        users?: string[] | undefined;
+    }, {
+        expression?: string | undefined;
+        groups?: string[] | undefined;
+        percentage?: number | undefined;
+        users?: string[] | undefined;
+    }>>;
+    /** Integration */
+    environment: z.ZodDefault<z.ZodEnum<["dev", "staging", "prod", "all"]>>;
+    /** Expiration */
+    expiresAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    strategy: "boolean" | "custom" | "group" | "percentage" | "user_list";
+    name: string;
+    enabled: boolean;
+    environment: "prod" | "dev" | "all" | "staging";
+    label?: string | undefined;
+    description?: string | undefined;
+    conditions?: {
+        expression?: string | undefined;
+        groups?: string[] | undefined;
+        percentage?: number | undefined;
+        users?: string[] | undefined;
+    } | undefined;
+    expiresAt?: string | undefined;
+}, {
+    name: string;
+    strategy?: "boolean" | "custom" | "group" | "percentage" | "user_list" | undefined;
+    label?: string | undefined;
+    description?: string | undefined;
+    enabled?: boolean | undefined;
+    conditions?: {
+        expression?: string | undefined;
+        groups?: string[] | undefined;
+        percentage?: number | undefined;
+        users?: string[] | undefined;
+    } | undefined;
+    environment?: "prod" | "dev" | "all" | "staging" | undefined;
+    expiresAt?: string | undefined;
+}>;
+export declare const FeatureFlag: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    /** Default state */
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    /** Rollout Strategy */
+    strategy: z.ZodDefault<z.ZodEnum<["boolean", "percentage", "user_list", "group", "custom"]>>;
+    /** Strategy Configuration */
+    conditions: z.ZodOptional<z.ZodObject<{
+        percentage: z.ZodOptional<z.ZodNumber>;
+        users: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        groups: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        expression: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        expression?: string | undefined;
+        groups?: string[] | undefined;
+        percentage?: number | undefined;
+        users?: string[] | undefined;
+    }, {
+        expression?: string | undefined;
+        groups?: string[] | undefined;
+        percentage?: number | undefined;
+        users?: string[] | undefined;
+    }>>;
+    /** Integration */
+    environment: z.ZodDefault<z.ZodEnum<["dev", "staging", "prod", "all"]>>;
+    /** Expiration */
+    expiresAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    strategy: "boolean" | "custom" | "group" | "percentage" | "user_list";
+    name: string;
+    enabled: boolean;
+    environment: "prod" | "dev" | "all" | "staging";
+    label?: string | undefined;
+    description?: string | undefined;
+    conditions?: {
+        expression?: string | undefined;
+        groups?: string[] | undefined;
+        percentage?: number | undefined;
+        users?: string[] | undefined;
+    } | undefined;
+    expiresAt?: string | undefined;
+}, {
+    name: string;
+    strategy?: "boolean" | "custom" | "group" | "percentage" | "user_list" | undefined;
+    label?: string | undefined;
+    description?: string | undefined;
+    enabled?: boolean | undefined;
+    conditions?: {
+        expression?: string | undefined;
+        groups?: string[] | undefined;
+        percentage?: number | undefined;
+        users?: string[] | undefined;
+    } | undefined;
+    environment?: "prod" | "dev" | "all" | "staging" | undefined;
+    expiresAt?: string | undefined;
+}> & {
+    create: <T extends z.input<typeof FeatureFlagSchema>>(config: T) => T;
+};
+export type FeatureFlag = z.infer<typeof FeatureFlagSchema>;
+//# sourceMappingURL=feature.zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature.zod.d.ts","sourceRoot":"","sources":["../../src/system/feature.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,eAAe,sEAM1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;IAK5B,oBAAoB;;IAGpB,uBAAuB;;IAGvB,6BAA6B;;;;;;;;;;;;;;;;;IAQ7B,kBAAkB;;IAIlB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;IAtBtB,oBAAoB;;IAGpB,uBAAuB;;IAGvB,6BAA6B;;;;;;;;;;;;;;;;;IAQ7B,kBAAkB;;IAIlB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAKR,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,UAAU,CAAC;CAC/D,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/system/feature.zod.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlag = exports.FeatureFlagSchema = exports.FeatureStrategy = void 0;
+const zod_1 = require("zod");
+const identifiers_zod_1 = require("../shared/identifiers.zod");
+/**
+ * Feature Rollout Strategy
+ */
+exports.FeatureStrategy = zod_1.z.enum([
+    'boolean', // Simple On/Off
+    'percentage', // Gradual rollout (0-100%)
+    'user_list', // Specific users
+    'group', // Specific groups/roles
+    'custom' // Custom constraint/script
+]);
+/**
+ * Feature Flag Protocol
+ *
+ * Manages feature toggles and gradual rollouts.
+ * Used for CI/CD, A/B Testing, and Trunk-Based Development.
+ */
+exports.FeatureFlagSchema = zod_1.z.object({
+    name: identifiers_zod_1.SnakeCaseIdentifierSchema.describe('Feature key (snake_case)'),
+    label: zod_1.z.string().optional().describe('Display label'),
+    description: zod_1.z.string().optional(),
+    /** Default state */
+    enabled: zod_1.z.boolean().default(false).describe('Is globally enabled'),
+    /** Rollout Strategy */
+    strategy: exports.FeatureStrategy.default('boolean'),
+    /** Strategy Configuration */
+    conditions: zod_1.z.object({
+        percentage: zod_1.z.number().min(0).max(100).optional(),
+        users: zod_1.z.array(zod_1.z.string()).optional(),
+        groups: zod_1.z.array(zod_1.z.string()).optional(),
+        expression: zod_1.z.string().optional().describe('Custom formula expression')
+    }).optional(),
+    /** Integration */
+    environment: zod_1.z.enum(['dev', 'staging', 'prod', 'all']).default('all')
+        .describe('Environment validity'),
+    /** Expiration */
+    expiresAt: zod_1.z.string().datetime().optional().describe('Feature flag expiration date'),
+});
+exports.FeatureFlag = Object.assign(exports.FeatureFlagSchema, {
+    create: (config) => config,
+});

package/dist/system/index.d.ts

@@ -3,31 +3,22 @@
  *
  * Runtime Configuration & Security
  * - Manifest (Config), Datasource
- * - Role (Hierarchy), Identity (Auth)
- * - Webhook (Integration), Policy (Compliance)
+ * - Webhook (Integration), Audit (Compliance)
  * - Plugin Architecture
  */
-export * from './manifest.zod';
-export * from './datasource.zod';
-export * from './api.zod';
-export * from './identity.zod';
-export * from './auth.zod';
-export * from './auth-protocol';
-export * from './organization.zod';
-export * from './policy.zod';
-export * from './role.zod';
-export * from './territory.zod';
-export * from './tenant.zod';
 export * from './audit.zod';
-export * from './license.zod';
-export * from './webhook.zod';
 export * from './translation.zod';
-export * from './driver.zod';
-export * from './discovery.zod';
-export * from './plugin.zod';
-export * from './realtime.zod';
 export * from './events.zod';
 export * from './job.zod';
-export * from './constants';
+export * from './feature.zod';
 export * from './types';
+export * from './manifest.zod';
+export * from './plugin.zod';
+export * from './logger.zod';
+export * from './context.zod';
+export * from './scoped-storage.zod';
+export * from './datasource.zod';
+export * from './driver.zod';
+export * from './driver/mongo.zod';
+export * from './driver/postgres.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;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,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"}

package/dist/system/index.js

@@ -4,8 +4,7 @@
  *
  * Runtime Configuration & Security
  * - Manifest (Config), Datasource
- * - Role (Hierarchy), Identity (Auth)
- * - Webhook (Integration), Policy (Compliance)
+ * - Webhook (Integration), Audit (Compliance)
  * - Plugin Architecture
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -23,26 +22,22 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./manifest.zod"), exports);
-__exportStar(require("./datasource.zod"), exports);
-__exportStar(require("./api.zod"), exports);
-__exportStar(require("./identity.zod"), exports);
-__exportStar(require("./auth.zod"), exports);
-__exportStar(require("./auth-protocol"), exports);
-__exportStar(require("./organization.zod"), exports);
-__exportStar(require("./policy.zod"), exports);
-__exportStar(require("./role.zod"), exports);
-__exportStar(require("./territory.zod"), exports);
-__exportStar(require("./tenant.zod"), exports);
 __exportStar(require("./audit.zod"), exports);
-__exportStar(require("./license.zod"), exports);
-__exportStar(require("./webhook.zod"), exports);
 __exportStar(require("./translation.zod"), exports);
-__exportStar(require("./driver.zod"), exports);
-__exportStar(require("./discovery.zod"), exports);
-__exportStar(require("./plugin.zod"), exports);
-__exportStar(require("./realtime.zod"), exports);
 __exportStar(require("./events.zod"), exports);
 __exportStar(require("./job.zod"), exports);
-__exportStar(require("./constants"), exports);
+__exportStar(require("./feature.zod"), exports);
 __exportStar(require("./types"), exports);
+// Re-export Core System Definitions
+__exportStar(require("./manifest.zod"), exports);
+__exportStar(require("./plugin.zod"), exports);
+__exportStar(require("./logger.zod"), exports);
+__exportStar(require("./context.zod"), exports);
+__exportStar(require("./scoped-storage.zod"), exports);
+__exportStar(require("./datasource.zod"), exports);
+// Driver Protocol
+__exportStar(require("./driver.zod"), exports);
+__exportStar(require("./driver/mongo.zod"), exports);
+__exportStar(require("./driver/postgres.zod"), exports);
+// Note: Auth, Identity, Policy, Role, Organization moved to @objectstack/spec/auth
+// Note: Territory moved to @objectstack/spec/permission

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

@@ -157,6 +157,9 @@ export declare const JobSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     name: string;
+    handler: (...args: unknown[]) => Promise<void>;
+    id: string;
+    enabled: boolean;
     schedule: {
         type: "cron";
         expression: string;
@@ -168,9 +171,6 @@ export declare const JobSchema: z.ZodObject<{
         at: string;
         type: "once";
     };
-    id: string;
-    enabled: boolean;
-    handler: (...args: unknown[]) => Promise<void>;
     timeout?: number | undefined;
     retryPolicy?: {
         maxRetries: number;
@@ -179,6 +179,8 @@ export declare const JobSchema: z.ZodObject<{
     } | undefined;
 }, {
     name: string;
+    handler: (...args: unknown[]) => Promise<void>;
+    id: string;
     schedule: {
         type: "cron";
         expression: string;
@@ -190,8 +192,6 @@ export declare const JobSchema: z.ZodObject<{
         at: string;
         type: "once";
     };
-    id: string;
-    handler: (...args: unknown[]) => Promise<void>;
     timeout?: number | undefined;
     enabled?: boolean | undefined;
     retryPolicy?: {