@objectql/types 4.1.0 → 4.2.1

package/dist/edge.d.ts

@@ -0,0 +1,86 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Supported edge runtime environments.
+ */
+export type EdgeRuntime = 'cloudflare-workers' | 'deno-deploy' | 'vercel-edge' | 'bun' | 'node';
+/**
+ * Edge-specific driver binding.
+ *
+ * Maps an ObjectQL driver to an edge-platform-native storage primitive.
+ * For example, Cloudflare Workers binds `driver-sqlite-wasm` to D1.
+ */
+export interface EdgeDriverBinding {
+    /**
+     * The ObjectQL driver package name.
+     * e.g., `'@objectql/driver-memory'`, `'@objectql/driver-sqlite-wasm'`
+     */
+    readonly driver: string;
+    /**
+     * Edge-platform binding name (environment variable or resource identifier).
+     * e.g., `'D1_DATABASE'` for Cloudflare D1, `'POSTGRES_URL'` for Deno Postgres.
+     */
+    readonly binding?: string;
+    /**
+     * Driver-specific configuration overrides for the edge environment.
+     */
+    readonly config?: Record<string, unknown>;
+}
+/**
+ * Edge runtime adapter configuration.
+ *
+ * Declares how ObjectQL should adapt to a specific edge runtime.
+ * Used by the edge adapter packages (e.g., `@objectql/adapter-cloudflare`).
+ */
+export interface EdgeAdapterConfig {
+    /** Target edge runtime */
+    readonly runtime: EdgeRuntime;
+    /**
+     * Driver bindings for this edge environment.
+     * Maps datasource names to edge-specific driver bindings.
+     */
+    readonly bindings?: Record<string, EdgeDriverBinding>;
+    /**
+     * Maximum execution time in milliseconds.
+     * Edge runtimes impose strict CPU time limits.
+     * Default varies by runtime (e.g., 30000 for Cloudflare Workers).
+     */
+    readonly maxExecutionTime?: number;
+    /**
+     * Enable request-scoped driver connections.
+     * Edge runtimes are stateless; connections are created per-request.
+     * Default: true
+     */
+    readonly requestScoped?: boolean;
+}
+/**
+ * Edge runtime environment capabilities.
+ *
+ * Declares what platform APIs are available in the target edge runtime.
+ * Used by ObjectQL to select compatible code paths.
+ */
+export interface EdgeCapabilities {
+    /** WebAssembly support */
+    readonly wasm: boolean;
+    /** Persistent storage available (OPFS, KV, D1, etc.) */
+    readonly persistentStorage: boolean;
+    /** WebSocket support for real-time sync */
+    readonly webSocket: boolean;
+    /** Cron/scheduled trigger support */
+    readonly scheduledTriggers: boolean;
+    /** Maximum request body size in bytes */
+    readonly maxRequestBodySize?: number;
+    /** Maximum execution time in milliseconds */
+    readonly maxExecutionTime?: number;
+    /** Available storage primitives */
+    readonly storagePrimitives: readonly string[];
+}
+/**
+ * Predefined edge capability profiles for known runtimes.
+ */
+export declare const EDGE_CAPABILITIES: Readonly<Record<EdgeRuntime, EdgeCapabilities>>;

package/dist/edge.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDGE_CAPABILITIES = void 0;
+/**
+ * Predefined edge capability profiles for known runtimes.
+ */
+exports.EDGE_CAPABILITIES = {
+    'cloudflare-workers': {
+        wasm: true,
+        persistentStorage: true,
+        webSocket: true,
+        scheduledTriggers: true,
+        maxRequestBodySize: 100 * 1024 * 1024, // 100MB
+        maxExecutionTime: 30000,
+        storagePrimitives: ['D1', 'KV', 'R2', 'Durable Objects'],
+    },
+    'deno-deploy': {
+        wasm: true,
+        persistentStorage: true,
+        webSocket: true,
+        scheduledTriggers: true,
+        maxRequestBodySize: 512 * 1024, // 512KB
+        maxExecutionTime: 50000,
+        storagePrimitives: ['Deno KV', 'Deno Postgres'],
+    },
+    'vercel-edge': {
+        wasm: true,
+        persistentStorage: false,
+        webSocket: false,
+        scheduledTriggers: false,
+        maxRequestBodySize: 4 * 1024 * 1024, // 4MB
+        maxExecutionTime: 25000,
+        storagePrimitives: ['KV (via Vercel KV)', 'Postgres (via Vercel Postgres)'],
+    },
+    'bun': {
+        wasm: true,
+        persistentStorage: true,
+        webSocket: true,
+        scheduledTriggers: false,
+        maxRequestBodySize: Infinity,
+        maxExecutionTime: Infinity,
+        storagePrimitives: ['SQLite (bun:sqlite)', 'File System'],
+    },
+    'node': {
+        wasm: true,
+        persistentStorage: true,
+        webSocket: true,
+        scheduledTriggers: false,
+        maxRequestBodySize: Infinity,
+        maxExecutionTime: Infinity,
+        storagePrimitives: ['All drivers'],
+    },
+};
+//# sourceMappingURL=edge.js.map

package/dist/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../src/edge.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAqGH;;GAEG;AACU,QAAA,iBAAiB,GAAoD;IAC9E,oBAAoB,EAAE;QAClB,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ;QAC/C,gBAAgB,EAAE,KAAM;QACxB,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC;KAC3D;IACD,aAAa,EAAE;QACX,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,GAAG,GAAG,IAAI,EAAE,QAAQ;QACxC,gBAAgB,EAAE,KAAM;QACxB,iBAAiB,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;KAClD;IACD,aAAa,EAAE;QACX,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,KAAK;QACxB,SAAS,EAAE,KAAK;QAChB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,MAAM;QAC3C,gBAAgB,EAAE,KAAM;QACxB,iBAAiB,EAAE,CAAC,oBAAoB,EAAE,gCAAgC,CAAC;KAC9E;IACD,KAAK,EAAE;QACH,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,QAAQ;QAC5B,gBAAgB,EAAE,QAAQ;QAC1B,iBAAiB,EAAE,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5D;IACD,MAAM,EAAE;QACJ,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,QAAQ;QAC5B,gBAAgB,EAAE,QAAQ;QAC1B,iBAAiB,EAAE,CAAC,aAAa,CAAC;KACrC;CACJ,CAAC"}

package/dist/field.d.ts

@@ -6,9 +6,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { Data } from '@objectstack/spec';
-type ProtocolFieldType = Data.FieldType;
-type Field = Data.Field;
-type SpecSelectOption = Data.SelectOption;
+import { z } from 'zod';
+type ProtocolFieldType = z.infer<typeof Data.FieldType>;
+type Field = z.infer<typeof Data.FieldSchema>;
+type SpecSelectOption = z.infer<typeof Data.SelectOption>;
 /**
  * Re-export Protocol Types from the Constitution
  * These are the wire-protocol standard types defined in @objectstack/spec
@@ -69,10 +70,10 @@ export interface ImageAttachmentData extends AttachmentData {
  * Runtime Field Type
  *
  * Extends the Protocol FieldType with runtime-specific types.
- * The Protocol Constitution defines the core field types.
- * We add runtime-specific types like 'vector', 'grid', 'location', 'object' here.
+ * The Protocol Constitution defines the core field types (including 'location' and 'vector').
+ * We add runtime-specific types like 'grid' and 'object' here.
  */
-export type FieldType = ProtocolFieldType | 'location' | 'object' | 'vector' | 'grid';
+export type FieldType = ProtocolFieldType | 'object' | 'grid';
 /**
  * Runtime Field Option
  *

package/dist/formula.js.map

@@ -1 +1 @@
-{"version":3,"file":"formula.js","sourceRoot":"","sources":["../src/formula.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;;;;GAQG;AAEH,+BAAoD;AA0OpD;;GAEG;AACH,IAAY,gBAwBX;AAxBD,WAAY,gBAAgB;IACxB,qCAAqC;IACrC,iDAA6B,CAAA;IAE7B,sCAAsC;IACtC,uDAAmC,CAAA;IAEnC,iCAAiC;IACjC,6CAAyB,CAAA;IAEzB,uBAAuB;IACvB,yDAAqC,CAAA;IAErC,2CAA2C;IAC3C,qDAAiC,CAAA;IAEjC,yBAAyB;IACzB,uCAAmB,CAAA;IAEnB,gDAAgD;IAChD,6DAAyC,CAAA;IAEzC,4BAA4B;IAC5B,mDAA+B,CAAA;AACnC,CAAC,EAxBW,gBAAgB,gCAAhB,gBAAgB,QAwB3B;AAmBD;;;GAGG;AACH,MAAa,YAAa,SAAQ,mBAAa;IAK3C,YACI,IAAsB,EACtB,OAAe,EACf,UAAmB,EACnB,OAA6B;QAE7B,KAAK,CAAC;YACF,IAAI,EAAE,IAAc;YACpB,OAAO;YACP,OAAO,EAAE;gBACL,kBAAkB,EAAE,IAAI;gBACxB,UAAU;gBACV,GAAG,OAAO;aACb;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAChC,CAAC;CACJ;AAzBD,oCAyBC"}
+{"version":3,"file":"formula.js","sourceRoot":"","sources":["../src/formula.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;;;;GAQG;AAEH,+BAAsC;AA0OtC;;GAEG;AACH,IAAY,gBAwBX;AAxBD,WAAY,gBAAgB;IACxB,qCAAqC;IACrC,iDAA6B,CAAA;IAE7B,sCAAsC;IACtC,uDAAmC,CAAA;IAEnC,iCAAiC;IACjC,6CAAyB,CAAA;IAEzB,uBAAuB;IACvB,yDAAqC,CAAA;IAErC,2CAA2C;IAC3C,qDAAiC,CAAA;IAEjC,yBAAyB;IACzB,uCAAmB,CAAA;IAEnB,gDAAgD;IAChD,6DAAyC,CAAA;IAEzC,4BAA4B;IAC5B,mDAA+B,CAAA;AACnC,CAAC,EAxBW,gBAAgB,gCAAhB,gBAAgB,QAwB3B;AAmBD;;;GAGG;AACH,MAAa,YAAa,SAAQ,mBAAa;IAK3C,YACI,IAAsB,EACtB,OAAe,EACf,UAAmB,EACnB,OAA6B;QAE7B,KAAK,CAAC;YACF,IAAI,EAAE,IAAc;YACpB,OAAO;YACP,OAAO,EAAE;gBACL,kBAAkB,EAAE,IAAI;gBACxB,UAAU;gBACV,GAAG,OAAO;aACb;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAChC,CAAC;CACJ;AAzBD,oCAyBC"}

package/dist/gateway.d.ts

@@ -10,14 +10,14 @@ export interface ApiRequest {
     path: string;
     method: ApiMethod;
     headers: Record<string, string | string[] | undefined>;
-    query: Record<string, any>;
-    body?: any;
+    query: Record<string, unknown>;
+    body?: unknown;
     protocol?: string;
 }
 export interface ApiResponse {
     status: number;
     headers?: Record<string, string | string[]>;
-    body: any;
+    body: unknown;
 }
 export interface GatewayProtocol {
     name: string;

package/dist/hook.d.ts

@@ -17,17 +17,17 @@ export type HookTiming = 'before' | 'after';
  * Minimal API surface exposed to hooks for performing side-effects or checks.
  */
 export interface HookAPI {
-    find(objectName: string, query?: any): Promise<any[]>;
-    findOne(objectName: string, id: string | number): Promise<any>;
-    count(objectName: string, query?: any): Promise<number>;
-    create(objectName: string, data: any): Promise<any>;
-    update(objectName: string, id: string | number, data: any): Promise<any>;
-    delete(objectName: string, id: string | number): Promise<any>;
+    find(objectName: string, query?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    findOne(objectName: string, id: string | number): Promise<Record<string, unknown> | null>;
+    count(objectName: string, query?: Record<string, unknown>): Promise<number>;
+    create(objectName: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    update(objectName: string, id: string | number, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    delete(objectName: string, id: string | number): Promise<Record<string, unknown>>;
 }
 /**
  * Base context available in all hooks.
  */
-export interface BaseHookContext<T = any> {
+export interface BaseHookContext<_T = Record<string, unknown>> {
     /** The name of the object (entity) being acted upon. */
     objectName: string;
     /** The triggering operation. */
@@ -37,28 +37,32 @@ export interface BaseHookContext<T = any> {
     /** User/Session context (Authentication info). */
     user?: {
         id: string | number;
-        [key: string]: any;
+        [key: string]: unknown;
     };
     /**
      * Shared state for passing data between matching 'before' and 'after' hooks.
      * e.g. Calculate a diff in 'beforeUpdate' and read it in 'afterUpdate'.
      */
-    state: Record<string, any>;
+    state: Record<string, unknown>;
 }
 /**
  * Context for Retrieval operations (Find, Count).
  */
-export interface RetrievalHookContext<T = any> extends BaseHookContext<T> {
+export interface RetrievalHookContext<T = Record<string, unknown>> extends BaseHookContext<T> {
     operation: 'find' | 'count';
-    /** The query criteria being executed. Modifiable in 'before' hooks. */
-    query: any;
+    /**
+     * The query criteria being executed. Modifiable in 'before' hooks.
+     * Typed as `object` (not `Record<string, unknown>`) because named interfaces
+     * like UnifiedQuery lack index signatures and aren't assignable to Record types.
+     */
+    query: object;
     /** The result of the query. Only available in 'after' hooks. */
     result?: T[] | number;
 }
 /**
  * Context for Modification operations (Create, Update, Delete).
  */
-export interface MutationHookContext<T = any> extends BaseHookContext<T> {
+export interface MutationHookContext<T = Record<string, unknown>> extends BaseHookContext<T> {
     operation: 'create' | 'update' | 'delete';
     /** The record ID. Undefined for 'create'. */
     id?: string | number;
@@ -83,7 +87,7 @@ export interface MutationHookContext<T = any> extends BaseHookContext<T> {
 /**
  * Specialized context for Updates, including change tracking.
  */
-export interface UpdateHookContext<T = any> extends MutationHookContext<T> {
+export interface UpdateHookContext<T = Record<string, unknown>> extends MutationHookContext<T> {
     operation: 'update';
     /**
      * Helper to check if a specific field is being modified.
@@ -94,7 +98,7 @@ export interface UpdateHookContext<T = any> extends MutationHookContext<T> {
 /**
  * Definition interface for a set of hooks for a specific object.
  */
-export interface ObjectHookDefinition<T = any> {
+export interface ObjectHookDefinition<T = Record<string, unknown>> {
     beforeFind?: (ctx: RetrievalHookContext<T>) => Promise<void> | void;
     afterFind?: (ctx: RetrievalHookContext<T>) => Promise<void> | void;
     beforeCount?: (ctx: RetrievalHookContext<T>) => Promise<void> | void;
@@ -107,5 +111,5 @@ export interface ObjectHookDefinition<T = any> {
     afterUpdate?: (ctx: UpdateHookContext<T>) => Promise<void> | void;
 }
 export type HookName = keyof ObjectHookDefinition;
-export type HookContext<T = any> = RetrievalHookContext<T> | MutationHookContext<T> | UpdateHookContext<T>;
-export type HookHandler<T = any> = (ctx: HookContext<T>) => Promise<void> | void;
+export type HookContext<T = Record<string, unknown>> = RetrievalHookContext<T> | MutationHookContext<T> | UpdateHookContext<T>;
+export type HookHandler<T = Record<string, unknown>> = (ctx: HookContext<T>) => Promise<void> | void;

package/dist/index.d.ts

@@ -33,3 +33,8 @@ export * from './workflow';
 export * from './formula';
 export * from './plugin';
 export * from './gateway';
+export * from './logger';
+export * from './ai';
+export * from './sync';
+export * from './edge';
+export * from './kernel-service';

package/dist/index.js

@@ -49,4 +49,9 @@ __exportStar(require("./workflow"), exports);
 __exportStar(require("./formula"), exports);
 __exportStar(require("./plugin"), exports);
 __exportStar(require("./gateway"), exports);
+__exportStar(require("./logger"), exports);
+__exportStar(require("./ai"), exports);
+__exportStar(require("./sync"), exports);
+__exportStar(require("./edge"), exports);
+__exportStar(require("./kernel-service"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH;;;;;;GAMG;AACH,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,+CAA6B;AAC7B,wCAAsB;AACtB,2CAAyB;AACzB,4CAA0B;AAC1B,+CAA6B;AAC7B,+CAA6B;AAC7B,2CAAyB;AACzB,gDAA8B;AAC9B,8CAA4B;AAC5B,wCAAsB;AACtB,6CAA2B;AAC3B,4CAA0B;AAC1B,2CAAyB;AACzB,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH;;;;;;GAMG;AACH,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,+CAA6B;AAC7B,wCAAsB;AACtB,2CAAyB;AACzB,4CAA0B;AAC1B,+CAA6B;AAC7B,+CAA6B;AAC7B,2CAAyB;AACzB,gDAA8B;AAC9B,8CAA4B;AAC5B,wCAAsB;AACtB,6CAA2B;AAC3B,4CAA0B;AAC1B,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,uCAAqB;AACrB,yCAAuB;AACvB,yCAAuB;AACvB,mDAAiC"}

package/dist/kernel-service.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Kernel Service Types
+ *
+ * Defines the 17 kernel services specified by the ObjectStack protocol.
+ * Each service maps to a set of protocol methods governed by the ObjectStackProtocol interface.
+ *
+ * @see https://protocol.objectstack.ai/docs/guides/kernel-services
+ */
+/**
+ * The 17 kernel services registered via CoreServiceName.
+ * Each service maps to a set of protocol methods.
+ */
+export type CoreServiceName = 'metadata' | 'data' | 'analytics' | 'auth' | 'ui' | 'workflow' | 'automation' | 'realtime' | 'notification' | 'ai' | 'i18n' | 'file-storage' | 'search' | 'cache' | 'queue' | 'job' | 'graphql';
+/**
+ * Criticality levels for kernel services.
+ * - required: System cannot start without this service
+ * - core: Falls back to in-memory implementation with a warning if missing
+ * - optional: Feature disabled; API returns 501 Not Implemented if missing
+ */
+export type ServiceCriticality = 'required' | 'core' | 'optional';
+/**
+ * Service availability status reported via the discovery endpoint.
+ */
+export type ServiceStatusValue = 'available' | 'degraded' | 'unavailable';
+/**
+ * Per-service status entry in the discovery response.
+ */
+export interface ServiceStatus {
+    /** Whether the service is enabled */
+    readonly enabled: boolean;
+    /** Current operational status */
+    readonly status: ServiceStatusValue;
+    /** Route mount point (if available) */
+    readonly route?: string;
+    /** Provider name (e.g., 'kernel', plugin name) */
+    readonly provider?: string;
+    /** Human-readable status message */
+    readonly message?: string;
+}
+/**
+ * Service criticality mapping per the kernel-services specification.
+ */
+export declare const SERVICE_CRITICALITY: Readonly<Record<CoreServiceName, ServiceCriticality>>;
+/**
+ * Discovery response structure returned by getDiscovery.
+ * Clients use this to determine which services are available and adapt UI accordingly.
+ */
+export interface KernelDiscoveryResponse {
+    /** Engine name */
+    readonly name: string;
+    /** API name identifier for the spec discovery endpoint */
+    readonly apiName: string;
+    /** Engine version */
+    readonly version: string;
+    /** Supported protocol transports */
+    readonly protocols: readonly string[];
+    /** Per-service status map */
+    readonly services: Readonly<Record<CoreServiceName, ServiceStatus>>;
+    /** Optional capabilities flags */
+    readonly capabilities?: {
+        readonly search: boolean;
+        readonly files: boolean;
+        readonly graphql: boolean;
+        readonly notifications: boolean;
+        readonly analytics: boolean;
+        readonly ai: boolean;
+        readonly i18n: boolean;
+        readonly workflow: boolean;
+        readonly websockets: boolean;
+    };
+    /** Optional endpoint URLs */
+    readonly endpoints?: {
+        readonly rest?: string;
+        readonly graphql?: string;
+        readonly websocket?: string;
+    };
+}

package/dist/kernel-service.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVICE_CRITICALITY = void 0;
+/**
+ * Service criticality mapping per the kernel-services specification.
+ */
+exports.SERVICE_CRITICALITY = {
+    metadata: 'required',
+    data: 'required',
+    analytics: 'optional',
+    auth: 'required',
+    ui: 'optional',
+    workflow: 'optional',
+    automation: 'optional',
+    realtime: 'optional',
+    notification: 'optional',
+    ai: 'optional',
+    i18n: 'optional',
+    'file-storage': 'optional',
+    search: 'optional',
+    cache: 'core',
+    queue: 'core',
+    job: 'core',
+    graphql: 'optional',
+};
+//# sourceMappingURL=kernel-service.js.map

package/dist/kernel-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-service.js","sourceRoot":"","sources":["../src/kernel-service.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA+DH;;GAEG;AACU,QAAA,mBAAmB,GAA0D;IACtF,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,UAAU;IACrB,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,UAAU;IACd,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,UAAU;IACtB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,UAAU;IACxB,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,UAAU;IAChB,cAAc,EAAE,UAAU;IAC1B,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,UAAU;CACtB,CAAC"}

package/dist/loader.d.ts

@@ -17,5 +17,5 @@ export interface LoaderPlugin {
     name: string;
     glob: string[];
     handler: LoaderHandler;
-    options?: any;
+    options?: Record<string, unknown>;
 }

package/dist/logger.d.ts

@@ -0,0 +1,126 @@
+/**
+ * ObjectQL - Logger Type Definitions
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * Defines the canonical Logger interface for the ObjectQL ecosystem.
+ * All packages must use this interface instead of direct console.* calls.
+ */
+/**
+ * Log severity levels (RFC 5424 Syslog)
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * Log output format
+ */
+export type LogFormat = 'json' | 'pretty' | 'compact';
+/**
+ * Structured log entry for serialization
+ */
+export interface LogEntry {
+    /** ISO 8601 timestamp */
+    readonly timestamp: string;
+    /** Log severity level */
+    readonly level: LogLevel;
+    /** Logger name / component identifier */
+    readonly name: string;
+    /** Human-readable message */
+    readonly message: string;
+    /** Structured metadata (key-value pairs) */
+    readonly data?: Record<string, unknown>;
+    /** Error object, if applicable */
+    readonly error?: {
+        readonly name: string;
+        readonly message: string;
+        readonly stack?: string;
+    };
+}
+/**
+ * Logger configuration
+ */
+export interface LoggerConfig {
+    /** Logger name / component identifier */
+    readonly name: string;
+    /** Minimum log level to emit */
+    readonly level?: LogLevel;
+    /** Output format */
+    readonly format?: LogFormat;
+}
+/**
+ * Canonical Logger interface for the ObjectQL ecosystem
+ *
+ * All packages must program against this interface.
+ * Implementations are provided by the runtime layer (`@objectstack/core`
+ * or a custom adapter), keeping foundation packages runtime-agnostic.
+ *
+ * @example
+ * ```typescript
+ * class MyPlugin {
+ *   private logger: Logger;
+ *   constructor(logger: Logger) {
+ *     this.logger = logger;
+ *   }
+ *   async process() {
+ *     this.logger.info('Processing started', { batch: 42 });
+ *   }
+ * }
+ * ```
+ */
+export interface Logger {
+    /** Finest-grained informational events */
+    trace(message: string, data?: Record<string, unknown>): void;
+    /** Detailed debug information */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /** Informational messages that highlight progress */
+    info(message: string, data?: Record<string, unknown>): void;
+    /** Potentially harmful situations */
+    warn(message: string, data?: Record<string, unknown>): void;
+    /** Error events that might still allow the application to continue */
+    error(message: string, error?: Error, data?: Record<string, unknown>): void;
+    /** Severe error events that will presumably lead to application abort */
+    fatal(message: string, error?: Error, data?: Record<string, unknown>): void;
+}
+/**
+ * Factory function signature for creating Logger instances.
+ * Typically provided by the runtime layer.
+ */
+export type LoggerFactory = (config: LoggerConfig) => Logger;
+/**
+ * Console-based Logger implementation
+ *
+ * A zero-dependency reference implementation suitable for:
+ * - Unit tests (without mocking an external logger library)
+ * - Development environments
+ * - Packages that cannot depend on `@objectstack/core`
+ *
+ * For production use, prefer the structured logger from `@objectstack/core`.
+ */
+export declare class ConsoleLogger implements Logger {
+    private readonly name;
+    private readonly level;
+    private static readonly LEVELS;
+    constructor(config: LoggerConfig);
+    private shouldLog;
+    private format;
+    trace(message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, error?: Error, data?: Record<string, unknown>): void;
+    fatal(message: string, error?: Error, data?: Record<string, unknown>): void;
+}
+/**
+ * No-op Logger implementation
+ *
+ * Useful for suppressing all log output (e.g., in benchmarks or silent tests).
+ */
+export declare class NullLogger implements Logger {
+    trace(): void;
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+    fatal(): void;
+}