ofcore 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,29 @@
+# ofcore
+
+`ofcore` adalah runtime core ringan untuk aplikasi TypeScript offline-first.
+Paket ini fokus pada primitive generik lintas domain, bukan logika bisnis domain spesifik.
+
+## What You Get
+- kontrak runtime inti (adapter + envelope + versioning),
+- primitive store framework-agnostic,
+- harness kontrak adapter untuk validasi perilaku.
+
+## Install
+```bash
+npm install ofcore
+```
+
+## Build and Validate
+- `npm run build`
+- `npm run verify:contract`
+- `npm run verify:logic`
+- `npm run ci:check`
+
+## Publish Checklist
+1. `npm run ci:check`
+2. `npm pack --dry-run`
+3. `npm publish --access public`
+
+## Documentation
+- Developer notes (internal detail): `docs/10-DEVELOPER-NOTES.md`
+- Documentation hub: `docs/00-DOCUMENTATION-HUB.md`

package/dist/contracts/ActivitySink.d.ts

@@ -0,0 +1,13 @@
+import type { DomainAuditActor, ScopeRef } from './CrossDomainPrimitives';
+export interface ActivityRecord {
+    activityId: string;
+    activityType: string;
+    occurredAt: string;
+    scopeRef?: ScopeRef;
+    actor?: DomainAuditActor;
+    payload?: Record<string, unknown>;
+    correlationId?: string;
+}
+export interface ActivitySink {
+    publish(record: ActivityRecord): Promise<void> | void;
+}

package/dist/contracts/ChecksumPrimitives.d.ts

@@ -0,0 +1,12 @@
+export type ChecksumAlgorithm = 'sha256' | 'hmac-sha256';
+export interface ChecksumInput {
+    algorithm: ChecksumAlgorithm;
+    payload: string;
+    secret?: string;
+}
+export interface ChecksumAdapter {
+    compute(input: ChecksumInput): Promise<string> | string;
+    verify?(input: ChecksumInput, expectedChecksum: string): Promise<boolean> | boolean;
+}
+export declare function normalizeChecksum(value: string): string;
+export declare function areChecksumsEqual(left: string, right: string): boolean;

package/dist/contracts/ContractVersioning.d.ts

@@ -0,0 +1,16 @@
+export interface ContractVersionInfo {
+    contractName: string;
+    version: string;
+    compatibleWith: string[];
+    deprecated?: boolean;
+    sunsetAt?: string;
+}
+export interface ContractChangeNote {
+    contractName: string;
+    fromVersion: string;
+    toVersion: string;
+    summary: string;
+    breaking: boolean;
+    migrationRequired: boolean;
+}
+export declare function isContractVersionCompatible(currentVersion: string, compatibleWith: string[], targetVersion: string): boolean;

package/dist/contracts/CrossDomainPrimitives.d.ts

@@ -0,0 +1,51 @@
+export interface ScopeRef {
+    tenantId?: string;
+    branchId?: string;
+    domain?: string;
+}
+export interface DomainAuditActor {
+    userId?: string;
+    role?: string;
+    source?: string;
+}
+export interface DomainAuditEntityRef {
+    domain: string;
+    entity: string;
+    id: string;
+}
+export interface DomainAuditEvent {
+    eventId: string;
+    eventType: string;
+    actor: DomainAuditActor;
+    entityRef: DomainAuditEntityRef;
+    changes: Record<string, unknown>;
+    correlationId?: string;
+    timestamp: string;
+}
+export type WorklistUrgency = 'low' | 'medium' | 'high' | 'critical';
+export interface WorklistItem {
+    id: string;
+    scopeRef: ScopeRef;
+    urgency: WorklistUrgency;
+    reasonCode: string;
+    reasonText: string;
+    suggestedActions: string[];
+    metrics?: Record<string, number>;
+    timestamp: string;
+}
+export interface PolicyVersionedConfig<TPayload = Record<string, unknown>> {
+    policyId: string;
+    scopeRef: ScopeRef;
+    version: number;
+    effectiveDate: string;
+    approvalRef?: string | null;
+    isActive: boolean;
+    payload: TPayload;
+}
+export interface ComplianceEvaluationResult {
+    evaluationId: string;
+    scopeRef: ScopeRef;
+    summary: Record<string, number>;
+    worklist: WorklistItem[];
+    evaluatedAt: string;
+}

package/dist/contracts/EncryptionAdapter.d.ts

@@ -0,0 +1,14 @@
+export interface EncryptionContext {
+    keyId?: string;
+    aad?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface EncryptionAdapter {
+    encrypt(plainText: string, context?: EncryptionContext): Promise<string> | string;
+    decrypt(cipherText: string, context?: EncryptionContext): Promise<string | null> | string | null;
+    rotateKey?(context: {
+        fromKeyId?: string;
+        toKeyId: string;
+        dryRun?: boolean;
+    }): Promise<void> | void;
+}

package/dist/contracts/ExportAdapter.d.ts

@@ -0,0 +1,5 @@
+export interface ExportAdapter {
+    getDocumentPath(fileName: string): string;
+    writeFile(path: string, content: string): Promise<void>;
+    share(path: string): Promise<void>;
+}

package/dist/contracts/HttpAdapter.d.ts

@@ -0,0 +1,17 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface HttpRequest {
+    method: HttpMethod;
+    url: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string | number | boolean | null | undefined>;
+    body?: unknown;
+    timeoutMs?: number;
+}
+export interface HttpResponse<T = unknown> {
+    status: number;
+    headers: Record<string, string>;
+    data: T;
+}
+export interface HttpAdapter {
+    request<T = unknown>(request: HttpRequest): Promise<HttpResponse<T>>;
+}

package/dist/contracts/HttpRetryPolicy.d.ts

@@ -0,0 +1,16 @@
+import type { HttpAdapter, HttpRequest, HttpResponse } from './HttpAdapter';
+export interface HttpRetryContext<T = unknown> {
+    request: HttpRequest;
+    attempt: number;
+    response?: HttpResponse<T>;
+    error?: unknown;
+}
+export interface HttpRetryPolicy {
+    shouldRetry<T = unknown>(context: HttpRetryContext<T>): boolean;
+    nextDelayMs<T = unknown>(context: HttpRetryContext<T>): number;
+}
+export interface HttpRetryExecutorOptions {
+    policy?: HttpRetryPolicy;
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare function executeHttpRequestWithRetry<T = unknown>(adapter: HttpAdapter, request: HttpRequest, options?: HttpRetryExecutorOptions): Promise<HttpResponse<T>>;

package/dist/contracts/LoggerAdapter.d.ts

@@ -0,0 +1,5 @@
+export interface LoggerAdapter {
+    logInfo(message: string, context?: Record<string, any>): void;
+    logWarn(message: string, context?: Record<string, any>): void;
+    logError(error: any, context?: Record<string, any>): void;
+}

package/dist/contracts/NotificationAdapter.d.ts

@@ -0,0 +1,15 @@
+export interface NotificationOptions {
+    channelId?: string;
+    title: string;
+    message: string;
+    [key: string]: unknown;
+}
+export interface NotificationAdapter {
+    configure(options: unknown): void;
+    createChannel(options: {
+        channelId: string;
+        channelName: string;
+        importance?: number;
+    }): void;
+    localNotification(options: NotificationOptions): void;
+}

package/dist/contracts/ResponseEnvelope.d.ts

@@ -0,0 +1,27 @@
+export interface ErrorDetail {
+    field?: string;
+    issue: string;
+    code?: string;
+}
+export interface ErrorEnvelope {
+    code: string;
+    message: string;
+    details?: ErrorDetail[];
+    correlationId?: string;
+    timestamp?: string;
+    retryable?: boolean;
+}
+export interface MetaEnvelope {
+    request_id?: string | null;
+    timestamp?: string;
+}
+export interface SuccessEnvelope<T> {
+    data: T;
+    meta?: MetaEnvelope;
+}
+export interface FailureEnvelope {
+    error: ErrorEnvelope;
+    meta?: MetaEnvelope;
+}
+export type ResponseEnvelope<T> = SuccessEnvelope<T> | FailureEnvelope;
+export declare function isFailureEnvelope<T>(value: ResponseEnvelope<T>): value is FailureEnvelope;

package/dist/contracts/SocketAdapter.d.ts

@@ -0,0 +1,12 @@
+export type SocketEventHandler = (payload: unknown) => void;
+export interface SocketConnectOptions {
+    url: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+}
+export interface SocketAdapter {
+    connect(options: SocketConnectOptions): Promise<void>;
+    disconnect(): Promise<void>;
+    subscribe(eventName: string, handler: SocketEventHandler): () => void;
+    publish(eventName: string, payload: unknown): Promise<void>;
+}

package/dist/defaults/ConsoleLoggerAdapter.d.ts

@@ -0,0 +1,7 @@
+import type { LoggerAdapter } from '../contracts/LoggerAdapter';
+export declare class ConsoleLoggerAdapter implements LoggerAdapter {
+    constructor(_context?: unknown);
+    logInfo(message: string, context?: Record<string, any>): void;
+    logWarn(message: string, context?: Record<string, any>): void;
+    logError(error: any, context?: Record<string, any>): void;
+}

package/dist/defaults/DefaultExportAdapter.d.ts

@@ -0,0 +1,7 @@
+import type { ExportAdapter } from '../contracts/ExportAdapter';
+export declare class DefaultExportAdapter implements ExportAdapter {
+    constructor(_context?: unknown);
+    getDocumentPath(fileName: string): string;
+    writeFile(_path: string, _content: string): Promise<void>;
+    share(_path: string): Promise<void>;
+}

package/dist/defaults/DefaultHttpAdapter.d.ts

@@ -0,0 +1,15 @@
+import type { HttpAdapter, HttpRequest, HttpResponse } from '../contracts/HttpAdapter';
+type FetchLike = (input: string, init?: Record<string, unknown>) => Promise<{
+    status: number;
+    headers?: {
+        forEach?: (callback: (value: string, key: string) => void) => void;
+    };
+    json?: () => Promise<unknown>;
+    text?: () => Promise<string>;
+}>;
+export declare class DefaultHttpAdapter implements HttpAdapter {
+    private readonly fetchImpl?;
+    constructor(fetchImpl?: FetchLike | undefined);
+    request<T = unknown>(request: HttpRequest): Promise<HttpResponse<T>>;
+}
+export {};

package/dist/defaults/ExponentialBackoffHttpPolicy.d.ts

@@ -0,0 +1,16 @@
+import type { HttpRetryContext, HttpRetryPolicy } from '../contracts/HttpRetryPolicy';
+export interface ExponentialBackoffHttpPolicyOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    retryableStatusCodes?: number[];
+}
+export declare class ExponentialBackoffHttpPolicy implements HttpRetryPolicy {
+    private readonly maxAttempts;
+    private readonly baseDelayMs;
+    private readonly maxDelayMs;
+    private readonly retryableStatusCodes;
+    constructor(options?: ExponentialBackoffHttpPolicyOptions);
+    shouldRetry<T = unknown>(context: HttpRetryContext<T>): boolean;
+    nextDelayMs<T = unknown>(context: HttpRetryContext<T>): number;
+}

package/dist/defaults/InMemoryDbAdapter.d.ts

@@ -0,0 +1,65 @@
+/**
+ * In-memory implementation of DbAdapter for testing and development.
+ * Fully compliant with the latest DbAdapter interface.
+ */
+import { DbAdapter, TableSchema, ColumnDefinition, DbSchema, QueryOptions, LiteralValue } from '../ports/DbAdapter';
+export declare class InMemoryDbAdapter implements DbAdapter {
+    schema: DbSchema;
+    private data;
+    /**
+     * Initialize with a full schema (e.g., from `schemas`).
+     */
+    setUpWithSchema(schema: DbSchema): Promise<void>;
+    /**
+     * Normalize value for comparison (handles Date, boolean, etc.)
+     */
+    private normalizeForComparison;
+    /**
+     * Evaluate a ValueExpression against a record (and joined records).
+     * @param record Record from main table
+     * @param joinedRecords Map of alias → record (for joins)
+     * @param expr ValueExpression to evaluate
+     * @param mainAlias Main table alias (default: 't0')
+     */
+    private evalValueExpr;
+    private buildFieldCondition;
+    /**
+     * Recursively evaluate FilterExpression.
+     */
+    private matchFilterExpression;
+    /**
+     * Simulate JOINs by pre-matching records (for testing only).
+     * Limited to one-to-many/many-to-one; no many-to-many or complex conditions.
+     */
+    private simulateJoins;
+    /**
+     * Extract field from record (handles alias.field and string field).
+     */
+    private extractField;
+    private extractAggregateField;
+    getSchemaVersion(): Promise<number>;
+    setSchemaVersion(version: number): Promise<void>;
+    addTable(table: TableSchema): Promise<void>;
+    addColumn(_table: string, _column: ColumnDefinition): Promise<void>;
+    get<T>(table: string, idOrOptions: string | QueryOptions): Promise<T | null>;
+    query<T>(table: string, options?: QueryOptions): Promise<T[]>;
+    create<T>(table: string, data: Partial<Record<string, LiteralValue>> & {
+        id: string;
+    }): Promise<T>;
+    update<T>(table: string, id: string, updates: Partial<Record<string, LiteralValue>>): Promise<T>;
+    delete(table: string, id: string): Promise<void>;
+    bulkCreate<T>(table: string, rows: Array<Partial<Record<string, LiteralValue>> & {
+        id: string;
+    }>): Promise<T[]>;
+    bulkUpdate<T>(table: string, rows: Array<{
+        id: string;
+        updates: Partial<Record<string, LiteralValue>>;
+    }>): Promise<T[]>;
+    private transactionDepth;
+    private snapshots;
+    /**
+     * Simpan snapshot seluruh database (shallow copy cukup karena data immutable dalam transaksi)
+     */
+    private takeSnapshot;
+    transaction<T>(callback: (tx: this) => Promise<T>): Promise<T>;
+}

package/dist/defaults/InMemorySocketAdapter.d.ts

@@ -0,0 +1,12 @@
+import type { SocketAdapter, SocketConnectOptions, SocketEventHandler } from '../contracts/SocketAdapter';
+export declare class InMemorySocketAdapter implements SocketAdapter {
+    private connected;
+    private listeners;
+    private connectionOptions?;
+    connect(options: SocketConnectOptions): Promise<void>;
+    disconnect(): Promise<void>;
+    subscribe(eventName: string, handler: SocketEventHandler): () => void;
+    publish(eventName: string, payload: unknown): Promise<void>;
+    isConnected(): boolean;
+    getConnectionOptions(): SocketConnectOptions | undefined;
+}

package/dist/defaults/MemoryActivitySink.d.ts

@@ -0,0 +1,8 @@
+import type { ActivityRecord, ActivitySink } from '../contracts/ActivitySink';
+export declare class MemoryActivitySink implements ActivitySink {
+    private readonly records;
+    constructor(_context?: unknown);
+    publish(record: ActivityRecord): void;
+    getRecords(): ActivityRecord[];
+    clear(): void;
+}

package/dist/defaults/MemoryStorageAdapter.d.ts

@@ -0,0 +1,8 @@
+import type { StorageAdapter } from '../ports/StorageAdapter';
+export declare class MemoryStorageAdapter implements StorageAdapter {
+    private readonly map;
+    constructor(_context?: unknown);
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}

package/dist/defaults/NoRetryHttpPolicy.d.ts

@@ -0,0 +1,6 @@
+import type { HttpRetryContext, HttpRetryPolicy } from '../contracts/HttpRetryPolicy';
+export declare class NoRetryHttpPolicy implements HttpRetryPolicy {
+    constructor(_context?: unknown);
+    shouldRetry<T = unknown>(_context: HttpRetryContext<T>): boolean;
+    nextDelayMs<T = unknown>(_context: HttpRetryContext<T>): number;
+}

package/dist/defaults/NoopActivitySink.d.ts

@@ -0,0 +1,5 @@
+import type { ActivityRecord, ActivitySink } from '../contracts/ActivitySink';
+export declare class NoopActivitySink implements ActivitySink {
+    constructor(_context?: unknown);
+    publish(_record: ActivityRecord): void;
+}

package/dist/defaults/NoopChecksumAdapter.d.ts

@@ -0,0 +1,6 @@
+import type { ChecksumAdapter, ChecksumInput } from '../contracts/ChecksumPrimitives';
+export declare class NoopChecksumAdapter implements ChecksumAdapter {
+    constructor(_context?: unknown);
+    compute(_input: ChecksumInput): string;
+    verify(_input: ChecksumInput, expectedChecksum: string): boolean;
+}

package/dist/defaults/NoopEncryptionAdapter.d.ts

@@ -0,0 +1,6 @@
+import type { EncryptionAdapter, EncryptionContext } from '../contracts/EncryptionAdapter';
+export declare class NoopEncryptionAdapter implements EncryptionAdapter {
+    constructor(_context?: unknown);
+    encrypt(plainText: string, _context?: EncryptionContext): string;
+    decrypt(cipherText: string, _context?: EncryptionContext): string;
+}

package/dist/defaults/NoopNotificationAdapter.d.ts

@@ -0,0 +1,11 @@
+import type { NotificationAdapter, NotificationOptions } from '../contracts/NotificationAdapter';
+export declare class NoopNotificationAdapter implements NotificationAdapter {
+    constructor(_context?: unknown);
+    configure(_options: unknown): void;
+    createChannel(_options: {
+        channelId: string;
+        channelName: string;
+        importance?: number;
+    }): void;
+    localNotification(_options: NotificationOptions): void;
+}

package/dist/index.cjs.js

@@ -0,0 +1 @@
+"use strict";var C=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var J=Object.prototype.hasOwnProperty;var Q=(o,t)=>{for(var e in t)C(o,e,{get:t[e],enumerable:!0})},G=(o,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of W(t))!J.call(o,n)&&n!==e&&C(o,n,{get:()=>t[n],enumerable:!(r=B(t,n))||r.enumerable});return o};var K=o=>G(C({},"__esModule",{value:!0}),o);var pt={};Q(pt,{ConsoleLoggerAdapter:()=>H,CoreAdapterRegistry:()=>k,CoreRuntime:()=>T,CoreRuntimeBuilder:()=>R,DefaultExportAdapter:()=>_,DefaultHttpAdapter:()=>I,DefaultPlatformAdapter:()=>P,ExponentialBackoffHttpPolicy:()=>F,InMemoryDbAdapter:()=>D,InMemorySocketAdapter:()=>M,MemoryActivitySink:()=>L,MemoryStorageAdapter:()=>$,NoRetryHttpPolicy:()=>w,NoopActivitySink:()=>x,NoopChecksumAdapter:()=>S,NoopEncryptionAdapter:()=>V,NoopNotificationAdapter:()=>O,applyPendingMigrations:()=>it,areChecksumsEqual:()=>Z,asReadonlyStore:()=>ct,createStore:()=>at,executeHttpRequestWithRetry:()=>Y,isContractVersionCompatible:()=>et,isFailureEnvelope:()=>tt,migrations:()=>U,normalizeChecksum:()=>E,runDbAdapterContractHarness:()=>st});module.exports=K(pt);var P=class{constructor(t){}getEnvVar(t){let e=globalThis.process;if(typeof e!="undefined"&&e.env)return e.env[t]}isOnline(){return typeof globalThis.navigator!="undefined"&&typeof globalThis.navigator.onLine!="undefined"?!!globalThis.navigator.onLine:!0}async hashPin(t){return`sha256:${t}`}async verifyPin(t,e){return await this.hashPin(t)===e}};async function X(o){o<=0||await new Promise(t=>setTimeout(t,o))}async function Y(o,t,e={}){var s;let r=e.policy,n=(s=e.sleep)!=null?s:X,i=1;for(;;)try{let a=await o.request(t);if(!r)return a;let p={request:t,attempt:i,response:a};if(!r.shouldRetry(p))return a;let c=Math.max(0,r.nextDelayMs(p));await n(c),i+=1}catch(a){if(!r)throw a;let p={request:t,attempt:i,error:a};if(!r.shouldRetry(p))throw a;let c=Math.max(0,r.nextDelayMs(p));await n(c),i+=1}}function E(o){return String(o||"").trim().toLowerCase()}function Z(o,t){return E(o)===E(t)}function tt(o){return typeof(o==null?void 0:o.error)=="object"&&o!==null}function et(o,t,e){return e===o?!0:t.includes(e)}var D=class{constructor(){this.schema={version:0,tables:[]};this.data={};this.transactionDepth=0;this.snapshots=[]}async setUpWithSchema(t){this.schema={...t},this.data={},t.tables.forEach(e=>{this.data[e.name]=[]})}normalizeForComparison(t){if(t instanceof Date)return t.getTime();if(typeof t=="boolean")return t?1:0;if(typeof t=="string"||typeof t=="number"||t==null)return t;if(Array.isArray(t))return t.map(e=>this.normalizeForComparison(e));if(typeof t=="object"&&t!==null)try{return JSON.stringify(t)}catch{return String(t)}return t}evalValueExpr(t,e,r,n="t0"){if(r.type==="column"){let i=r.tableAlias||n,s=i===n?t:e[i]||{};return this.normalizeForComparison(s[r.field])}if(r.type==="literal")return this.normalizeForComparison(r.value);throw new Error(`Unsupported ValueExpression type: ${r.type}`)}buildFieldCondition(t,e){if("field"in t){let n={type:"column",tableAlias:t.alias||e,field:t.field},i={type:"literal",value:t.value};return{left:n,operator:t.operator||"=",right:i,...t.operator==="BETWEEN"?{}:{likeMode:t.likeMode}}}if("left"in t)return t;throw new Error("Invalid FieldCondition")}matchFilterExpression(t,e,r,n="t0"){if(r&&typeof r=="object"&&!Array.isArray(r)&&"and"in r)return r.and.every(i=>this.matchFilterExpression(t,e,i,n));if(r&&typeof r=="object"&&!Array.isArray(r)&&"or"in r)return r.or.some(i=>this.matchFilterExpression(t,e,i,n));if(r!==null&&typeof r=="object"&&!Array.isArray(r)){if("left"in r||"field"in r){let i=this.buildFieldCondition(r,n),s=this.evalValueExpr(t,e,i.left,n),a=this.evalValueExpr(t,e,i.right,n);if(i.operator==="IS NULL")return s==null;if(i.operator==="IS NOT NULL")return s!=null;if(i.operator==="IN"||i.operator==="NOT IN"){if(!Array.isArray(a))throw new Error("IN/NOT IN requires array on right side");let p=a.includes(s);return i.operator==="IN"?p:!p}switch(i.operator){case"=":return s===a;case"!=":return s!==a;case"<":return s<a;case"<=":return s<=a;case">":return s>a;case">=":return s>=a;case"LIKE":{if(typeof s!="string"||typeof a!="string")return!1;let p=a.replace(/%/g,".*").replace(/_/g,"."),c=i.likeMode;return new RegExp(`^${p}$`,c==="case-insensitive"?"i":"").test(s)}default:throw new Error(`Unsupported operator: ${i.operator}`)}}return Object.entries(r).every(([i,s])=>{let a=this.normalizeForComparison(t[i]),p=this.normalizeForComparison(s);return a===p})}throw new Error(`Invalid filter expression: ${JSON.stringify(r)}`)}simulateJoins(t,e,r){if(r.length===0)return e.map(i=>({record:i,joined:{}}));let n=[];for(let i of e){let s={},a=!0;for(let p of r){let c=p.table,d=this.data[c]||[],m=null;if(p.conditions.length===1){let l=p.conditions[0];if(l.operator==="="&&l.left.type==="column"&&l.right.type==="column"){let g=l.left.tableAlias||"t0",f=l.right.tableAlias;if(g==="t0"&&f===p.alias){let y=l.left.field,u=l.right.field,h=i[y];m=d.find(A=>this.normalizeForComparison(A[u])===this.normalizeForComparison(h))}}}if(!m&&(p.type==="inner"||p.type===void 0)){a=!1;break}s[p.alias]=m||null}a&&n.push({record:i,joined:s})}return n}extractField(t,e,r,n="t0"){if(typeof r=="string")return this.normalizeForComparison(t[r]);let i=r.tableAlias||n,s=i===n?t:e[i]||{};return this.normalizeForComparison(s[r.field])}extractAggregateField(t,e,r,n="t0"){if(typeof r=="string")return this.normalizeForComparison(t[r]);let i=r.tableAlias||n,s=i===n?t:e[i]||{};return this.normalizeForComparison(s[r.field])}async getSchemaVersion(){return this.schema.version}async setSchemaVersion(t){this.schema.version=t}async addTable(t){this.data[t.name]||(this.data[t.name]=[]),this.schema.tables.find(e=>e.name===t.name)||this.schema.tables.push(t)}async addColumn(t,e){}async get(t,e){var n;if(typeof e=="string"){let s=(this.data[t]||[]).find(a=>a.id===e);return s||null}return(n=(await this.query(t,{...e,limit:1}))[0])!=null?n:null}async query(t,e={}){var c;let n=[...this.data[t]||[]],i=this.simulateJoins(t,n,e.joins||[]);if(e.filters&&(i=i.filter(({record:d,joined:m})=>this.matchFilterExpression(d,m,e.filters,"t0"))),e.aggregates&&e.aggregates.length>0){let d={};for(let m of e.aggregates){let l=i;m.filter&&(l=l.filter(({record:u,joined:h})=>this.matchFilterExpression(u,h,m.filter,"t0")));let g=l.map(({record:u,joined:h})=>this.extractAggregateField(u,h,m.field,"t0")),f=g.map(u=>typeof u=="number"?u:Number(u)).filter(u=>Number.isFinite(u)),y=null;switch(m.function){case"COUNT":y=g.filter(u=>u!=null).length;break;case"SUM":y=f.reduce((u,h)=>u+h,0);break;case"AVG":y=f.length?f.reduce((u,h)=>u+h,0)/f.length:0;break;case"MIN":y=f.length?Math.min(...f):null;break;case"MAX":y=f.length?Math.max(...f):null;break;default:throw new Error(`Unsupported aggregate function: ${m.function}`)}d[m.as]=y}return[d]}let s=i.map(({record:d,joined:m})=>{if(e.fields){let l={};for(let[g,f]of Object.entries(e.fields)){let y=g==="t0"?d:m[g]||{};for(let u of f)l[`${g}_${u}`]=y[u]}return l}return d});e.sort&&e.sort.length>0&&s.sort((d,m)=>{for(let l of e.sort){let g=this.extractField(d,{},l.field,"t0"),f=this.extractField(m,{},l.field,"t0");if(g<f)return l.direction==="asc"?-1:1;if(g>f)return l.direction==="asc"?1:-1}return 0});let a=(c=e.offset)!=null?c:0,p=e.limit!=null?a+e.limit:void 0;return s.slice(a,p)}async create(t,e){this.data[t]||(this.data[t]=[]);let r={...e};return this.data[t].push(r),r}async update(t,e,r){let n=this.data[t]||[],i=n.findIndex(a=>a.id===e);if(i===-1)throw new Error(`Record not found: ${t} with id ${e}`);let s={...n[i],...r};return n[i]=s,s}async delete(t,e){let r=this.data[t]||[],n=r.findIndex(i=>i.id===e);n>=0&&r.splice(n,1)}async bulkCreate(t,e){this.data[t]||(this.data[t]=[]);let r=[...this.data[t]];try{let n=[];for(let i of e){let s={...i};this.data[t].push(s),n.push(s)}return n}catch(n){throw this.data[t]=r,n}}async bulkUpdate(t,e){let r=[...this.data[t]||[]];try{let n=[];for(let{id:i,updates:s}of e){let a=await this.update(t,i,s);n.push(a)}return n}catch(n){throw this.data[t]=r,n}}takeSnapshot(){let t={};for(let e in this.data)t[e]=[...this.data[e]];return t}async transaction(t){let e=this.transactionDepth===0;e&&this.snapshots.push(this.takeSnapshot()),this.transactionDepth++;try{let r=await t(this);return e&&this.snapshots.pop(),this.transactionDepth--,r}catch(r){if(e){let n=this.snapshots.pop();n&&(this.data=n)}throw this.transactionDepth--,r}}};var H=class{constructor(t){}logInfo(t,e){console.log(t,e)}logWarn(t,e){console.warn(t,e)}logError(t,e){console.error(t,e)}};function rt(o,t){if(!t||Object.keys(t).length===0)return o;let e=new URLSearchParams;for(let[n,i]of Object.entries(t))i!=null&&e.set(n,String(i));let r=e.toString();return r?o.includes("?")?`${o}&${r}`:`${o}?${r}`:o}var I=class{constructor(t){this.fetchImpl=t}async request(t){var s,a,p,c,d,m,l,g,f;let e=(s=this.fetchImpl)!=null?s:globalThis.fetch;if(typeof e!="function")throw new Error("DefaultHttpAdapter requires fetch implementation");let r=rt(t.url,t.query),n=typeof AbortController!="undefined"?new AbortController:null,i=n&&t.timeoutMs?setTimeout(()=>n.abort(),t.timeoutMs):null;try{let y=t.body!==void 0&&t.body!==null,u={...(a=t.headers)!=null?a:{}};y&&!u["content-type"]&&(u["content-type"]="application/json");let h=await e(r,{method:t.method,headers:u,body:y?JSON.stringify(t.body):void 0,signal:n==null?void 0:n.signal}),A={};(c=(p=h.headers)==null?void 0:p.forEach)==null||c.call(p,(z,q)=>{A[q.toLowerCase()]=z});let j=((d=A["content-type"])!=null?d:"").includes("application/json")?await((l=(m=h.json)==null?void 0:m.call(h))!=null?l:Promise.resolve(void 0)):await((f=(g=h.text)==null?void 0:g.call(h))!=null?f:Promise.resolve(""));return{status:h.status,headers:A,data:j}}finally{i&&clearTimeout(i)}}};var w=class{constructor(t){}shouldRetry(t){return!1}nextDelayMs(t){return 0}};var nt=[408,425,429,500,502,503,504],F=class{constructor(t={}){var e,r,n,i;this.maxAttempts=Math.max(1,(e=t.maxAttempts)!=null?e:3),this.baseDelayMs=Math.max(0,(r=t.baseDelayMs)!=null?r:250),this.maxDelayMs=Math.max(this.baseDelayMs,(n=t.maxDelayMs)!=null?n:3e3),this.retryableStatusCodes=new Set((i=t.retryableStatusCodes)!=null?i:nt)}shouldRetry(t){var r,n;if(t.attempt>=this.maxAttempts)return!1;if(t.error)return!0;let e=(n=(r=t.response)==null?void 0:r.status)!=null?n:0;return this.retryableStatusCodes.has(e)}nextDelayMs(t){let e=Math.max(0,t.attempt-1),r=this.baseDelayMs*Math.pow(2,e);return Math.min(this.maxDelayMs,r)}};var M=class{constructor(){this.connected=!1;this.listeners=new Map}async connect(t){this.connectionOptions=t,this.connected=!0}async disconnect(){this.connected=!1}subscribe(t,e){this.listeners.has(t)||this.listeners.set(t,new Set);let r=this.listeners.get(t);return r.add(e),()=>{r.delete(e),r.size===0&&this.listeners.delete(t)}}async publish(t,e){if(!this.connected)throw new Error(`InMemorySocketAdapter is not connected (event=${t})`);let r=this.listeners.get(t);if(!(!r||r.size===0))for(let n of r)n(e)}isConnected(){return this.connected}getConnectionOptions(){return this.connectionOptions}};var O=class{constructor(t){}configure(t){}createChannel(t){}localNotification(t){}};var V=class{constructor(t){}encrypt(t,e){return String(t)}decrypt(t,e){return String(t)}};var S=class{constructor(t){}compute(t){return""}verify(t,e){return String(e||"").trim()===""}};var x=class{constructor(t){}publish(t){}};var L=class{constructor(t){this.records=[]}publish(t){this.records.push(t)}getRecords(){return[...this.records]}clear(){this.records.length=0}};var _=class{constructor(t){}getDocumentPath(t){return t}async writeFile(t,e){throw new Error("exportAdapter.writeFile is not implemented for this platform")}async share(t){throw new Error("exportAdapter.share is not implemented for this platform")}};var $=class{constructor(t){this.map=new Map}getItem(t){var e;return(e=this.map.get(t))!=null?e:null}setItem(t,e){this.map.set(t,e)}removeItem(t){this.map.delete(t)}};var U=[];async function it(o,t){if(typeof o.getSchemaVersion!="function"||typeof o.setSchemaVersion!="function"){let e="Adapter does not support schema versioning (getSchemaVersion/setSchemaVersion required)";throw t.logError(new Error(e),{message:e}),new Error(e)}t.logInfo("Starting database migration process");try{let e=[...U].sort((i,s)=>i.toVersion-s.toVersion),r=e.length>0?e[e.length-1].toVersion:0,n=await o.getSchemaVersion();if((n==null||n<0)&&(n=0),n>=r){t.logInfo(`Database is already up-to-date at v${n}`);return}t.logInfo(`Migrating database from v${n} to v${r}`);for(let i of e)i.toVersion>n&&(t.logInfo(`Applying migration: v${i.toVersion}`),await i.up(o),await o.setSchemaVersion(i.toVersion),n=i.toVersion);t.logInfo("Database migration completed successfully")}catch(e){throw t.logError(e,{message:"Database migration failed"}),e}}function v(o,t){if(!o)throw new Error(t)}function b(o,t){return`${o}-${t}`}function ot(o){let t=[{name:"id",type:"string"},{name:"name",type:"string"},{name:"age",type:"number"},{name:"tenantId",type:"string"},{name:"isActive",type:"boolean"}];return{name:`${o}_users`,columns:t,skipMetadataColumns:!0}}async function st(o,t={}){var u;let e=((u=t.prefix)!=null?u:`dbadapter_${Date.now()}`).replace(/[^a-zA-Z0-9_]/g,"_"),r=`${e}_users`;await o.setSchemaVersion(7);let n=await o.getSchemaVersion();v(n===7,`Expected schema version 7, got ${n}`),await o.addTable(ot(e)),await o.addColumn(r,{name:"email",type:"string",isOptional:!0}),await o.create(r,{id:b(e,"u1"),name:"Alice",age:31,tenantId:"tenant-1",isActive:!0,email:"alice@example.com"}),await o.create(r,{id:b(e,"u2"),name:"Bob",age:24,tenantId:"tenant-1",isActive:!1,email:"bob@example.com"}),await o.bulkCreate(r,[{id:b(e,"u3"),name:"Carla",age:29,tenantId:"tenant-2",isActive:!0,email:"carla@example.com"},{id:b(e,"u4"),name:"Dian",age:22,tenantId:"tenant-2",isActive:!0}]);let i=await o.get(r,b(e,"u1"));v((i==null?void 0:i.name)==="Alice","Expected get(table, id) to return Alice");let s=await o.query(r,{filters:{tenantId:"tenant-1"},sort:[{field:"age",direction:"desc"}]});v(s.length===2,`Expected 2 tenant-1 users, got ${s.length}`),v(s[0].age>=s[1].age,"Expected sorted by age desc");let a={and:[{field:"tenantId",value:"tenant-2"},{field:"isActive",value:!0}]},p=await o.query(r,{filters:a,sort:[{field:"name",direction:"asc"}]});v(p.length===2,`Expected 2 active tenant-2 users, got ${p.length}`);let c={filters:{and:[{field:"id",value:b(e,"u2")},{field:"tenantId",value:"tenant-1"}]}},d=await o.get(r,c);v((d==null?void 0:d.name)==="Bob","Expected get(table, options) to resolve Bob");let m=await o.update(r,b(e,"u1"),{age:32});v(m.age===32,`Expected age updated to 32, got ${m.age}`);let l=await o.bulkUpdate(r,[{id:b(e,"u3"),updates:{age:30}},{id:b(e,"u4"),updates:{age:23}}]);v(l.length===2,`Expected 2 bulk-updated rows, got ${l.length}`);let g=await o.query(r,{sort:[{field:"age",direction:"asc"}],limit:2,offset:1});v(g.length===2,`Expected 2 paged rows, got ${g.length}`);try{throw await o.transaction(async h=>{throw await h.create(r,{id:b(e,"tx_rollback"),name:"TxRollback",age:40,tenantId:"tenant-1",isActive:!0}),new Error("rollback-intent")}),new Error("Expected transaction rollback to throw")}catch(h){let A=h instanceof Error?h.message:String(h);v(A.includes("rollback-intent"),`Expected rollback-intent error, got ${A}`)}let f=await o.get(r,b(e,"tx_rollback"));v(f===null,"Expected rolled back record to not exist"),await o.delete(r,b(e,"u2"));let y=await o.get(r,b(e,"u2"));v(y===null,"Expected deleted record to be null")}var k=class{constructor(t,e){this.extensions=new Map;var r,n,i,s,a,p,c,d,m,l,g,f,y;this.platformAdapter=(r=e.platformAdapter)==null?void 0:r.call(e,t),this.dbAdapter=(n=e.dbAdapter)==null?void 0:n.call(e,t),this.loggerAdapter=(i=e.loggerAdapter)==null?void 0:i.call(e,t),this.httpAdapter=(s=e.httpAdapter)==null?void 0:s.call(e,t),this.httpRetryPolicy=(p=(a=e.httpRetryPolicy)==null?void 0:a.call(e,t))!=null?p:new w(t),this.socketAdapter=(c=e.socketAdapter)==null?void 0:c.call(e,t),this.encryptionAdapter=(d=e.encryptionAdapter)==null?void 0:d.call(e,t),this.checksumAdapter=(l=(m=e.checksumAdapter)==null?void 0:m.call(e,t))!=null?l:new S(t),this.activitySink=(f=(g=e.activitySink)==null?void 0:g.call(e,t))!=null?f:new x(t);for(let[u,h]of Object.entries((y=e.extensions)!=null?y:{}))this.extensions.set(u,h(t))}getExtension(t){return this.extensions.get(t)}clear(){this.extensions.clear()}};function N(o){return!!o&&typeof o.shutdown=="function"}var T=class{constructor(){this.correlationCounter=0;this.started=!1;this.pluginsLoaded=!1;this.pendingPlugins=[];this.hooks={}}static builder(){return new R}setHooks(t){this.hooks={...this.hooks,...t}}use(t,e,r=[]){if(!t.trim())throw new Error("plugin name is required");return this.pendingPlugins.some(n=>n.name===t)?this:(this.pendingPlugins.push({name:t,init:e,deps:r}),this)}async init(t={runMigrations:!0,useSeedData:!1}){if(!this.registry)throw new Error("CoreRuntime registry is not initialized. Call builder().build() first.");if(t.runMigrations!==!1&&this.hooks.runMigrations&&await this.hooks.runMigrations(this),this.hooks.onInit&&await this.hooks.onInit(this),!this.domainServices&&this.hooks.createDomainServices&&(this.domainServices=await this.hooks.createDomainServices(this)),!this.integrationServices&&this.hooks.createIntegrationServices&&(this.integrationServices=await this.hooks.createIntegrationServices(this)),!this.pluginsLoaded){let n=this.resolvePluginLevels();for(let i of n)await Promise.all(i.map(s=>s.init(this)));this.pluginsLoaded=!0}t.useSeedData===!0&&this.hooks.runSeed&&await this.hooks.runSeed(this)}async start(t={}){if(this.started)throw new Error("CoreRuntime already started");try{await this.init(t),this.started=!0}catch(e){throw this.started=!1,e}}async stop(){var t;this.started&&(this.hooks.onStop&&await this.hooks.onStop(this),N(this.integrationServices)&&await this.integrationServices.shutdown(),N(this.domainServices)&&await this.domainServices.shutdown(),(t=this.registry)==null||t.clear(),this.started=!1)}async reset(){await this.stop(),this.domainServices=void 0,this.integrationServices=void 0,this.pendingPlugins=[],this.pluginsLoaded=!1,this.hooks={}}async restart(){let t=[...this.pendingPlugins],e={...this.hooks};await this.reset(),this.pendingPlugins=t,this.hooks=e,await this.start()}isStarted(){return this.started}createCorrelationId(t="cid"){return this.correlationCounter+=1,`${t}-${Date.now()}-${this.correlationCounter}`}logInfo(t,e){var r,n;(n=(r=this.registry)==null?void 0:r.loggerAdapter)==null||n.logInfo(t,e)}logWarn(t,e){var r,n;(n=(r=this.registry)==null?void 0:r.loggerAdapter)==null||n.logWarn(t,e)}logError(t,e){var r,n;(n=(r=this.registry)==null?void 0:r.loggerAdapter)==null||n.logError(t,e)}async emitActivity(t){var e;(e=this.registry)!=null&&e.activitySink&&await this.registry.activitySink.publish(t)}resolvePluginLevels(){var s,a,p;if(this.pendingPlugins.length===0)return[];let t=new Map,e=new Map,r=new Map;for(let c of this.pendingPlugins){if(t.has(c.name))throw new Error(`Duplicate plugin name: ${c.name}`);t.set(c.name,[]),e.set(c.name,0),r.set(c.name,c)}for(let c of this.pendingPlugins)for(let d of c.deps){if(!t.has(d))throw new Error(`Plugin "${c.name}" depends on unknown plugin "${d}"`);t.get(d).push(c.name),e.set(c.name,((s=e.get(c.name))!=null?s:0)+1)}let n=[],i=Array.from(e.entries()).filter(([,c])=>c===0).map(([c])=>c);for(;i.length>0;){let c=i.map(m=>r.get(m));n.push(c);let d=[];for(let m of i)for(let l of(a=t.get(m))!=null?a:[]){let g=((p=e.get(l))!=null?p:0)-1;e.set(l,g),g===0&&d.push(l)}i=d}if(n.flat().length!==this.pendingPlugins.length)throw new Error("Circular dependency detected among plugins");return n}},R=class{constructor(){this.runtime=new T;this.adapterOptions={};this.hooks={}}withPlatformAdapter(t){return this.adapterOptions.platformAdapter=t,this}withDbAdapter(t){return this.adapterOptions.dbAdapter=t,this}withHttpAdapter(t){return this.adapterOptions.httpAdapter=t,this}withHttpRetryPolicy(t){return this.adapterOptions.httpRetryPolicy=t,this}withSocketAdapter(t){return this.adapterOptions.socketAdapter=t,this}withEncryptionAdapter(t){return this.adapterOptions.encryptionAdapter=t,this}withChecksumAdapter(t){return this.adapterOptions.checksumAdapter=t,this}withActivitySink(t){return this.adapterOptions.activitySink=t,this}withLoggerAdapter(t){return this.adapterOptions.loggerAdapter=t,this}withExtension(t,e){var r;return this.adapterOptions.extensions=(r=this.adapterOptions.extensions)!=null?r:{},this.adapterOptions.extensions[t]=e,this}withHooks(t){return this.hooks={...this.hooks,...t},this}build(){return this.runtime.setHooks(this.hooks),this.runtime.registry=new k(this.runtime,this.adapterOptions),this.runtime}};function at(o){let t=o,e=new Set,r=(n,i)=>{for(let s of e)s(n,i)};return{getState(){return t},setState(n){let i=t;return t=typeof n=="function"?n(t):{...t,...n},r(t,i),t},reset(n){let i=t;return t=n!=null?n:o,r(t,i),t},subscribe(n){return e.add(n),()=>{e.delete(n)}}}}function ct(o){return{getState:o.getState,subscribe:o.subscribe}}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export * from './ports/DbAdapter';
+export * from './ports/PlatformAdapter';
+export * from './ports/StorageAdapter';
+export * from './contracts/LoggerAdapter';
+export * from './contracts/HttpAdapter';
+export * from './contracts/HttpRetryPolicy';
+export * from './contracts/SocketAdapter';
+export * from './contracts/NotificationAdapter';
+export * from './contracts/ExportAdapter';
+export * from './contracts/EncryptionAdapter';
+export * from './contracts/ActivitySink';
+export * from './contracts/ChecksumPrimitives';
+export * from './contracts/ResponseEnvelope';
+export * from './contracts/ContractVersioning';
+export * from './contracts/CrossDomainPrimitives';
+export * from './defaults/InMemoryDbAdapter';
+export * from './defaults/ConsoleLoggerAdapter';
+export * from './defaults/DefaultHttpAdapter';
+export * from './defaults/NoRetryHttpPolicy';
+export * from './defaults/ExponentialBackoffHttpPolicy';
+export * from './defaults/InMemorySocketAdapter';
+export * from './defaults/NoopNotificationAdapter';
+export * from './defaults/NoopEncryptionAdapter';
+export * from './defaults/NoopChecksumAdapter';
+export * from './defaults/NoopActivitySink';
+export * from './defaults/MemoryActivitySink';
+export * from './defaults/DefaultExportAdapter';
+export * from './defaults/MemoryStorageAdapter';
+export * from './migration/types';
+export * from './migration/migrations';
+export * from './migration/applyPendingMigrations';
+export * from './testing/DbAdapterContractHarness';
+export * from './runtime/CoreRuntime';
+export * from './runtime/createStore';

package/dist/index.esm.js

@@ -0,0 +1 @@
+var C=class{constructor(t){}getEnvVar(t){let e=globalThis.process;if(typeof e!="undefined"&&e.env)return e.env[t]}isOnline(){return typeof globalThis.navigator!="undefined"&&typeof globalThis.navigator.onLine!="undefined"?!!globalThis.navigator.onLine:!0}async hashPin(t){return`sha256:${t}`}async verifyPin(t,e){return await this.hashPin(t)===e}};async function q(o){o<=0||await new Promise(t=>setTimeout(t,o))}async function K(o,t,e={}){var s;let r=e.policy,n=(s=e.sleep)!=null?s:q,i=1;for(;;)try{let a=await o.request(t);if(!r)return a;let p={request:t,attempt:i,response:a};if(!r.shouldRetry(p))return a;let c=Math.max(0,r.nextDelayMs(p));await n(c),i+=1}catch(a){if(!r)throw a;let p={request:t,attempt:i,error:a};if(!r.shouldRetry(p))throw a;let c=Math.max(0,r.nextDelayMs(p));await n(c),i+=1}}function P(o){return String(o||"").trim().toLowerCase()}function Y(o,t){return P(o)===P(t)}function tt(o){return typeof(o==null?void 0:o.error)=="object"&&o!==null}function rt(o,t,e){return e===o?!0:t.includes(e)}var E=class{constructor(){this.schema={version:0,tables:[]};this.data={};this.transactionDepth=0;this.snapshots=[]}async setUpWithSchema(t){this.schema={...t},this.data={},t.tables.forEach(e=>{this.data[e.name]=[]})}normalizeForComparison(t){if(t instanceof Date)return t.getTime();if(typeof t=="boolean")return t?1:0;if(typeof t=="string"||typeof t=="number"||t==null)return t;if(Array.isArray(t))return t.map(e=>this.normalizeForComparison(e));if(typeof t=="object"&&t!==null)try{return JSON.stringify(t)}catch{return String(t)}return t}evalValueExpr(t,e,r,n="t0"){if(r.type==="column"){let i=r.tableAlias||n,s=i===n?t:e[i]||{};return this.normalizeForComparison(s[r.field])}if(r.type==="literal")return this.normalizeForComparison(r.value);throw new Error(`Unsupported ValueExpression type: ${r.type}`)}buildFieldCondition(t,e){if("field"in t){let n={type:"column",tableAlias:t.alias||e,field:t.field},i={type:"literal",value:t.value};return{left:n,operator:t.operator||"=",right:i,...t.operator==="BETWEEN"?{}:{likeMode:t.likeMode}}}if("left"in t)return t;throw new Error("Invalid FieldCondition")}matchFilterExpression(t,e,r,n="t0"){if(r&&typeof r=="object"&&!Array.isArray(r)&&"and"in r)return r.and.every(i=>this.matchFilterExpression(t,e,i,n));if(r&&typeof r=="object"&&!Array.isArray(r)&&"or"in r)return r.or.some(i=>this.matchFilterExpression(t,e,i,n));if(r!==null&&typeof r=="object"&&!Array.isArray(r)){if("left"in r||"field"in r){let i=this.buildFieldCondition(r,n),s=this.evalValueExpr(t,e,i.left,n),a=this.evalValueExpr(t,e,i.right,n);if(i.operator==="IS NULL")return s==null;if(i.operator==="IS NOT NULL")return s!=null;if(i.operator==="IN"||i.operator==="NOT IN"){if(!Array.isArray(a))throw new Error("IN/NOT IN requires array on right side");let p=a.includes(s);return i.operator==="IN"?p:!p}switch(i.operator){case"=":return s===a;case"!=":return s!==a;case"<":return s<a;case"<=":return s<=a;case">":return s>a;case">=":return s>=a;case"LIKE":{if(typeof s!="string"||typeof a!="string")return!1;let p=a.replace(/%/g,".*").replace(/_/g,"."),c=i.likeMode;return new RegExp(`^${p}$`,c==="case-insensitive"?"i":"").test(s)}default:throw new Error(`Unsupported operator: ${i.operator}`)}}return Object.entries(r).every(([i,s])=>{let a=this.normalizeForComparison(t[i]),p=this.normalizeForComparison(s);return a===p})}throw new Error(`Invalid filter expression: ${JSON.stringify(r)}`)}simulateJoins(t,e,r){if(r.length===0)return e.map(i=>({record:i,joined:{}}));let n=[];for(let i of e){let s={},a=!0;for(let p of r){let c=p.table,d=this.data[c]||[],m=null;if(p.conditions.length===1){let l=p.conditions[0];if(l.operator==="="&&l.left.type==="column"&&l.right.type==="column"){let g=l.left.tableAlias||"t0",f=l.right.tableAlias;if(g==="t0"&&f===p.alias){let y=l.left.field,u=l.right.field,h=i[y];m=d.find(A=>this.normalizeForComparison(A[u])===this.normalizeForComparison(h))}}}if(!m&&(p.type==="inner"||p.type===void 0)){a=!1;break}s[p.alias]=m||null}a&&n.push({record:i,joined:s})}return n}extractField(t,e,r,n="t0"){if(typeof r=="string")return this.normalizeForComparison(t[r]);let i=r.tableAlias||n,s=i===n?t:e[i]||{};return this.normalizeForComparison(s[r.field])}extractAggregateField(t,e,r,n="t0"){if(typeof r=="string")return this.normalizeForComparison(t[r]);let i=r.tableAlias||n,s=i===n?t:e[i]||{};return this.normalizeForComparison(s[r.field])}async getSchemaVersion(){return this.schema.version}async setSchemaVersion(t){this.schema.version=t}async addTable(t){this.data[t.name]||(this.data[t.name]=[]),this.schema.tables.find(e=>e.name===t.name)||this.schema.tables.push(t)}async addColumn(t,e){}async get(t,e){var n;if(typeof e=="string"){let s=(this.data[t]||[]).find(a=>a.id===e);return s||null}return(n=(await this.query(t,{...e,limit:1}))[0])!=null?n:null}async query(t,e={}){var c;let n=[...this.data[t]||[]],i=this.simulateJoins(t,n,e.joins||[]);if(e.filters&&(i=i.filter(({record:d,joined:m})=>this.matchFilterExpression(d,m,e.filters,"t0"))),e.aggregates&&e.aggregates.length>0){let d={};for(let m of e.aggregates){let l=i;m.filter&&(l=l.filter(({record:u,joined:h})=>this.matchFilterExpression(u,h,m.filter,"t0")));let g=l.map(({record:u,joined:h})=>this.extractAggregateField(u,h,m.field,"t0")),f=g.map(u=>typeof u=="number"?u:Number(u)).filter(u=>Number.isFinite(u)),y=null;switch(m.function){case"COUNT":y=g.filter(u=>u!=null).length;break;case"SUM":y=f.reduce((u,h)=>u+h,0);break;case"AVG":y=f.length?f.reduce((u,h)=>u+h,0)/f.length:0;break;case"MIN":y=f.length?Math.min(...f):null;break;case"MAX":y=f.length?Math.max(...f):null;break;default:throw new Error(`Unsupported aggregate function: ${m.function}`)}d[m.as]=y}return[d]}let s=i.map(({record:d,joined:m})=>{if(e.fields){let l={};for(let[g,f]of Object.entries(e.fields)){let y=g==="t0"?d:m[g]||{};for(let u of f)l[`${g}_${u}`]=y[u]}return l}return d});e.sort&&e.sort.length>0&&s.sort((d,m)=>{for(let l of e.sort){let g=this.extractField(d,{},l.field,"t0"),f=this.extractField(m,{},l.field,"t0");if(g<f)return l.direction==="asc"?-1:1;if(g>f)return l.direction==="asc"?1:-1}return 0});let a=(c=e.offset)!=null?c:0,p=e.limit!=null?a+e.limit:void 0;return s.slice(a,p)}async create(t,e){this.data[t]||(this.data[t]=[]);let r={...e};return this.data[t].push(r),r}async update(t,e,r){let n=this.data[t]||[],i=n.findIndex(a=>a.id===e);if(i===-1)throw new Error(`Record not found: ${t} with id ${e}`);let s={...n[i],...r};return n[i]=s,s}async delete(t,e){let r=this.data[t]||[],n=r.findIndex(i=>i.id===e);n>=0&&r.splice(n,1)}async bulkCreate(t,e){this.data[t]||(this.data[t]=[]);let r=[...this.data[t]];try{let n=[];for(let i of e){let s={...i};this.data[t].push(s),n.push(s)}return n}catch(n){throw this.data[t]=r,n}}async bulkUpdate(t,e){let r=[...this.data[t]||[]];try{let n=[];for(let{id:i,updates:s}of e){let a=await this.update(t,i,s);n.push(a)}return n}catch(n){throw this.data[t]=r,n}}takeSnapshot(){let t={};for(let e in this.data)t[e]=[...this.data[e]];return t}async transaction(t){let e=this.transactionDepth===0;e&&this.snapshots.push(this.takeSnapshot()),this.transactionDepth++;try{let r=await t(this);return e&&this.snapshots.pop(),this.transactionDepth--,r}catch(r){if(e){let n=this.snapshots.pop();n&&(this.data=n)}throw this.transactionDepth--,r}}};var D=class{constructor(t){}logInfo(t,e){console.log(t,e)}logWarn(t,e){console.warn(t,e)}logError(t,e){console.error(t,e)}};function B(o,t){if(!t||Object.keys(t).length===0)return o;let e=new URLSearchParams;for(let[n,i]of Object.entries(t))i!=null&&e.set(n,String(i));let r=e.toString();return r?o.includes("?")?`${o}&${r}`:`${o}?${r}`:o}var H=class{constructor(t){this.fetchImpl=t}async request(t){var s,a,p,c,d,m,l,g,f;let e=(s=this.fetchImpl)!=null?s:globalThis.fetch;if(typeof e!="function")throw new Error("DefaultHttpAdapter requires fetch implementation");let r=B(t.url,t.query),n=typeof AbortController!="undefined"?new AbortController:null,i=n&&t.timeoutMs?setTimeout(()=>n.abort(),t.timeoutMs):null;try{let y=t.body!==void 0&&t.body!==null,u={...(a=t.headers)!=null?a:{}};y&&!u["content-type"]&&(u["content-type"]="application/json");let h=await e(r,{method:t.method,headers:u,body:y?JSON.stringify(t.body):void 0,signal:n==null?void 0:n.signal}),A={};(c=(p=h.headers)==null?void 0:p.forEach)==null||c.call(p,(j,z)=>{A[z.toLowerCase()]=j});let N=((d=A["content-type"])!=null?d:"").includes("application/json")?await((l=(m=h.json)==null?void 0:m.call(h))!=null?l:Promise.resolve(void 0)):await((f=(g=h.text)==null?void 0:g.call(h))!=null?f:Promise.resolve(""));return{status:h.status,headers:A,data:N}}finally{i&&clearTimeout(i)}}};var w=class{constructor(t){}shouldRetry(t){return!1}nextDelayMs(t){return 0}};var W=[408,425,429,500,502,503,504],I=class{constructor(t={}){var e,r,n,i;this.maxAttempts=Math.max(1,(e=t.maxAttempts)!=null?e:3),this.baseDelayMs=Math.max(0,(r=t.baseDelayMs)!=null?r:250),this.maxDelayMs=Math.max(this.baseDelayMs,(n=t.maxDelayMs)!=null?n:3e3),this.retryableStatusCodes=new Set((i=t.retryableStatusCodes)!=null?i:W)}shouldRetry(t){var r,n;if(t.attempt>=this.maxAttempts)return!1;if(t.error)return!0;let e=(n=(r=t.response)==null?void 0:r.status)!=null?n:0;return this.retryableStatusCodes.has(e)}nextDelayMs(t){let e=Math.max(0,t.attempt-1),r=this.baseDelayMs*Math.pow(2,e);return Math.min(this.maxDelayMs,r)}};var F=class{constructor(){this.connected=!1;this.listeners=new Map}async connect(t){this.connectionOptions=t,this.connected=!0}async disconnect(){this.connected=!1}subscribe(t,e){this.listeners.has(t)||this.listeners.set(t,new Set);let r=this.listeners.get(t);return r.add(e),()=>{r.delete(e),r.size===0&&this.listeners.delete(t)}}async publish(t,e){if(!this.connected)throw new Error(`InMemorySocketAdapter is not connected (event=${t})`);let r=this.listeners.get(t);if(!(!r||r.size===0))for(let n of r)n(e)}isConnected(){return this.connected}getConnectionOptions(){return this.connectionOptions}};var M=class{constructor(t){}configure(t){}createChannel(t){}localNotification(t){}};var O=class{constructor(t){}encrypt(t,e){return String(t)}decrypt(t,e){return String(t)}};var S=class{constructor(t){}compute(t){return""}verify(t,e){return String(e||"").trim()===""}};var x=class{constructor(t){}publish(t){}};var V=class{constructor(t){this.records=[]}publish(t){this.records.push(t)}getRecords(){return[...this.records]}clear(){this.records.length=0}};var L=class{constructor(t){}getDocumentPath(t){return t}async writeFile(t,e){throw new Error("exportAdapter.writeFile is not implemented for this platform")}async share(t){throw new Error("exportAdapter.share is not implemented for this platform")}};var _=class{constructor(t){this.map=new Map}getItem(t){var e;return(e=this.map.get(t))!=null?e:null}setItem(t,e){this.map.set(t,e)}removeItem(t){this.map.delete(t)}};var $=[];async function vt(o,t){if(typeof o.getSchemaVersion!="function"||typeof o.setSchemaVersion!="function"){let e="Adapter does not support schema versioning (getSchemaVersion/setSchemaVersion required)";throw t.logError(new Error(e),{message:e}),new Error(e)}t.logInfo("Starting database migration process");try{let e=[...$].sort((i,s)=>i.toVersion-s.toVersion),r=e.length>0?e[e.length-1].toVersion:0,n=await o.getSchemaVersion();if((n==null||n<0)&&(n=0),n>=r){t.logInfo(`Database is already up-to-date at v${n}`);return}t.logInfo(`Migrating database from v${n} to v${r}`);for(let i of e)i.toVersion>n&&(t.logInfo(`Applying migration: v${i.toVersion}`),await i.up(o),await o.setSchemaVersion(i.toVersion),n=i.toVersion);t.logInfo("Database migration completed successfully")}catch(e){throw t.logError(e,{message:"Database migration failed"}),e}}function v(o,t){if(!o)throw new Error(t)}function b(o,t){return`${o}-${t}`}function J(o){let t=[{name:"id",type:"string"},{name:"name",type:"string"},{name:"age",type:"number"},{name:"tenantId",type:"string"},{name:"isActive",type:"boolean"}];return{name:`${o}_users`,columns:t,skipMetadataColumns:!0}}async function wt(o,t={}){var u;let e=((u=t.prefix)!=null?u:`dbadapter_${Date.now()}`).replace(/[^a-zA-Z0-9_]/g,"_"),r=`${e}_users`;await o.setSchemaVersion(7);let n=await o.getSchemaVersion();v(n===7,`Expected schema version 7, got ${n}`),await o.addTable(J(e)),await o.addColumn(r,{name:"email",type:"string",isOptional:!0}),await o.create(r,{id:b(e,"u1"),name:"Alice",age:31,tenantId:"tenant-1",isActive:!0,email:"alice@example.com"}),await o.create(r,{id:b(e,"u2"),name:"Bob",age:24,tenantId:"tenant-1",isActive:!1,email:"bob@example.com"}),await o.bulkCreate(r,[{id:b(e,"u3"),name:"Carla",age:29,tenantId:"tenant-2",isActive:!0,email:"carla@example.com"},{id:b(e,"u4"),name:"Dian",age:22,tenantId:"tenant-2",isActive:!0}]);let i=await o.get(r,b(e,"u1"));v((i==null?void 0:i.name)==="Alice","Expected get(table, id) to return Alice");let s=await o.query(r,{filters:{tenantId:"tenant-1"},sort:[{field:"age",direction:"desc"}]});v(s.length===2,`Expected 2 tenant-1 users, got ${s.length}`),v(s[0].age>=s[1].age,"Expected sorted by age desc");let a={and:[{field:"tenantId",value:"tenant-2"},{field:"isActive",value:!0}]},p=await o.query(r,{filters:a,sort:[{field:"name",direction:"asc"}]});v(p.length===2,`Expected 2 active tenant-2 users, got ${p.length}`);let c={filters:{and:[{field:"id",value:b(e,"u2")},{field:"tenantId",value:"tenant-1"}]}},d=await o.get(r,c);v((d==null?void 0:d.name)==="Bob","Expected get(table, options) to resolve Bob");let m=await o.update(r,b(e,"u1"),{age:32});v(m.age===32,`Expected age updated to 32, got ${m.age}`);let l=await o.bulkUpdate(r,[{id:b(e,"u3"),updates:{age:30}},{id:b(e,"u4"),updates:{age:23}}]);v(l.length===2,`Expected 2 bulk-updated rows, got ${l.length}`);let g=await o.query(r,{sort:[{field:"age",direction:"asc"}],limit:2,offset:1});v(g.length===2,`Expected 2 paged rows, got ${g.length}`);try{throw await o.transaction(async h=>{throw await h.create(r,{id:b(e,"tx_rollback"),name:"TxRollback",age:40,tenantId:"tenant-1",isActive:!0}),new Error("rollback-intent")}),new Error("Expected transaction rollback to throw")}catch(h){let A=h instanceof Error?h.message:String(h);v(A.includes("rollback-intent"),`Expected rollback-intent error, got ${A}`)}let f=await o.get(r,b(e,"tx_rollback"));v(f===null,"Expected rolled back record to not exist"),await o.delete(r,b(e,"u2"));let y=await o.get(r,b(e,"u2"));v(y===null,"Expected deleted record to be null")}var k=class{constructor(t,e){this.extensions=new Map;var r,n,i,s,a,p,c,d,m,l,g,f,y;this.platformAdapter=(r=e.platformAdapter)==null?void 0:r.call(e,t),this.dbAdapter=(n=e.dbAdapter)==null?void 0:n.call(e,t),this.loggerAdapter=(i=e.loggerAdapter)==null?void 0:i.call(e,t),this.httpAdapter=(s=e.httpAdapter)==null?void 0:s.call(e,t),this.httpRetryPolicy=(p=(a=e.httpRetryPolicy)==null?void 0:a.call(e,t))!=null?p:new w(t),this.socketAdapter=(c=e.socketAdapter)==null?void 0:c.call(e,t),this.encryptionAdapter=(d=e.encryptionAdapter)==null?void 0:d.call(e,t),this.checksumAdapter=(l=(m=e.checksumAdapter)==null?void 0:m.call(e,t))!=null?l:new S(t),this.activitySink=(f=(g=e.activitySink)==null?void 0:g.call(e,t))!=null?f:new x(t);for(let[u,h]of Object.entries((y=e.extensions)!=null?y:{}))this.extensions.set(u,h(t))}getExtension(t){return this.extensions.get(t)}clear(){this.extensions.clear()}};function U(o){return!!o&&typeof o.shutdown=="function"}var T=class{constructor(){this.correlationCounter=0;this.started=!1;this.pluginsLoaded=!1;this.pendingPlugins=[];this.hooks={}}static builder(){return new R}setHooks(t){this.hooks={...this.hooks,...t}}use(t,e,r=[]){if(!t.trim())throw new Error("plugin name is required");return this.pendingPlugins.some(n=>n.name===t)?this:(this.pendingPlugins.push({name:t,init:e,deps:r}),this)}async init(t={runMigrations:!0,useSeedData:!1}){if(!this.registry)throw new Error("CoreRuntime registry is not initialized. Call builder().build() first.");if(t.runMigrations!==!1&&this.hooks.runMigrations&&await this.hooks.runMigrations(this),this.hooks.onInit&&await this.hooks.onInit(this),!this.domainServices&&this.hooks.createDomainServices&&(this.domainServices=await this.hooks.createDomainServices(this)),!this.integrationServices&&this.hooks.createIntegrationServices&&(this.integrationServices=await this.hooks.createIntegrationServices(this)),!this.pluginsLoaded){let n=this.resolvePluginLevels();for(let i of n)await Promise.all(i.map(s=>s.init(this)));this.pluginsLoaded=!0}t.useSeedData===!0&&this.hooks.runSeed&&await this.hooks.runSeed(this)}async start(t={}){if(this.started)throw new Error("CoreRuntime already started");try{await this.init(t),this.started=!0}catch(e){throw this.started=!1,e}}async stop(){var t;this.started&&(this.hooks.onStop&&await this.hooks.onStop(this),U(this.integrationServices)&&await this.integrationServices.shutdown(),U(this.domainServices)&&await this.domainServices.shutdown(),(t=this.registry)==null||t.clear(),this.started=!1)}async reset(){await this.stop(),this.domainServices=void 0,this.integrationServices=void 0,this.pendingPlugins=[],this.pluginsLoaded=!1,this.hooks={}}async restart(){let t=[...this.pendingPlugins],e={...this.hooks};await this.reset(),this.pendingPlugins=t,this.hooks=e,await this.start()}isStarted(){return this.started}createCorrelationId(t="cid"){return this.correlationCounter+=1,`${t}-${Date.now()}-${this.correlationCounter}`}logInfo(t,e){var r,n;(n=(r=this.registry)==null?void 0:r.loggerAdapter)==null||n.logInfo(t,e)}logWarn(t,e){var r,n;(n=(r=this.registry)==null?void 0:r.loggerAdapter)==null||n.logWarn(t,e)}logError(t,e){var r,n;(n=(r=this.registry)==null?void 0:r.loggerAdapter)==null||n.logError(t,e)}async emitActivity(t){var e;(e=this.registry)!=null&&e.activitySink&&await this.registry.activitySink.publish(t)}resolvePluginLevels(){var s,a,p;if(this.pendingPlugins.length===0)return[];let t=new Map,e=new Map,r=new Map;for(let c of this.pendingPlugins){if(t.has(c.name))throw new Error(`Duplicate plugin name: ${c.name}`);t.set(c.name,[]),e.set(c.name,0),r.set(c.name,c)}for(let c of this.pendingPlugins)for(let d of c.deps){if(!t.has(d))throw new Error(`Plugin "${c.name}" depends on unknown plugin "${d}"`);t.get(d).push(c.name),e.set(c.name,((s=e.get(c.name))!=null?s:0)+1)}let n=[],i=Array.from(e.entries()).filter(([,c])=>c===0).map(([c])=>c);for(;i.length>0;){let c=i.map(m=>r.get(m));n.push(c);let d=[];for(let m of i)for(let l of(a=t.get(m))!=null?a:[]){let g=((p=e.get(l))!=null?p:0)-1;e.set(l,g),g===0&&d.push(l)}i=d}if(n.flat().length!==this.pendingPlugins.length)throw new Error("Circular dependency detected among plugins");return n}},R=class{constructor(){this.runtime=new T;this.adapterOptions={};this.hooks={}}withPlatformAdapter(t){return this.adapterOptions.platformAdapter=t,this}withDbAdapter(t){return this.adapterOptions.dbAdapter=t,this}withHttpAdapter(t){return this.adapterOptions.httpAdapter=t,this}withHttpRetryPolicy(t){return this.adapterOptions.httpRetryPolicy=t,this}withSocketAdapter(t){return this.adapterOptions.socketAdapter=t,this}withEncryptionAdapter(t){return this.adapterOptions.encryptionAdapter=t,this}withChecksumAdapter(t){return this.adapterOptions.checksumAdapter=t,this}withActivitySink(t){return this.adapterOptions.activitySink=t,this}withLoggerAdapter(t){return this.adapterOptions.loggerAdapter=t,this}withExtension(t,e){var r;return this.adapterOptions.extensions=(r=this.adapterOptions.extensions)!=null?r:{},this.adapterOptions.extensions[t]=e,this}withHooks(t){return this.hooks={...this.hooks,...t},this}build(){return this.runtime.setHooks(this.hooks),this.runtime.registry=new k(this.runtime,this.adapterOptions),this.runtime}};function Ct(o){let t=o,e=new Set,r=(n,i)=>{for(let s of e)s(n,i)};return{getState(){return t},setState(n){let i=t;return t=typeof n=="function"?n(t):{...t,...n},r(t,i),t},reset(n){let i=t;return t=n!=null?n:o,r(t,i),t},subscribe(n){return e.add(n),()=>{e.delete(n)}}}}function Pt(o){return{getState:o.getState,subscribe:o.subscribe}}export{D as ConsoleLoggerAdapter,k as CoreAdapterRegistry,T as CoreRuntime,R as CoreRuntimeBuilder,L as DefaultExportAdapter,H as DefaultHttpAdapter,C as DefaultPlatformAdapter,I as ExponentialBackoffHttpPolicy,E as InMemoryDbAdapter,F as InMemorySocketAdapter,V as MemoryActivitySink,_ as MemoryStorageAdapter,w as NoRetryHttpPolicy,x as NoopActivitySink,S as NoopChecksumAdapter,O as NoopEncryptionAdapter,M as NoopNotificationAdapter,vt as applyPendingMigrations,Y as areChecksumsEqual,Pt as asReadonlyStore,Ct as createStore,K as executeHttpRequestWithRetry,rt as isContractVersionCompatible,tt as isFailureEnvelope,$ as migrations,P as normalizeChecksum,wt as runDbAdapterContractHarness};

package/dist/migration/applyPendingMigrations.d.ts

@@ -0,0 +1,10 @@
+import type { DbAdapter } from '../ports/DbAdapter';
+import type { LoggerAdapter } from '../contracts/LoggerAdapter';
+/**
+ * Generic migration gate helper.
+ *
+ * Catatan fase skeleton:
+ * - Daftar migrasi disuplai dari pemanggil.
+ * - Tidak mengandung domain schema apapun.
+ */
+export declare function applyPendingMigrations(adapter: Partial<DbAdapter>, logger: LoggerAdapter): Promise<void>;

package/dist/migration/migrations.d.ts

@@ -0,0 +1,6 @@
+import type { Migration } from './types';
+/**
+ * Placeholder migration registry for ofcore skeleton.
+ * Domain packages may compose/extend this strategy in later phases.
+ */
+export declare const migrations: Migration[];

package/dist/migration/types.d.ts

@@ -0,0 +1,5 @@
+import type { DbAdapter } from '../ports/DbAdapter';
+export interface Migration {
+    toVersion: number;
+    up(adapter: DbAdapter): Promise<void>;
+}

package/dist/ports/DbAdapter.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Database Adapter Interface — Database-Agnostic, Type-Safe, and Secure by Design.
+ *
+ * Design principles:
+ * - No raw strings for identifiers or values in interface (prevents injection at contract level)
+ * - All expressions structured and type-safe
+ * - Shorthand syntax preserved for great DX
+ * - Case behavior for LIKE controlled via 'likeMode' (intent-based, not syntax-based)
+ * - Fully implementable by PostgreSQL, SQLite, MySQL, SQL Server, etc.
+ */
+/**
+ * Aggregate function yang didukung semua database utama.
+ */
+export type AggregateFunction = 'SUM' | 'COUNT' | 'AVG' | 'MIN' | 'MAX';
+/**
+ * Spesifikasi aggregate — field bisa dari main table atau joined table.
+ */
+export interface AggregateSpec {
+    function: AggregateFunction;
+    /**
+     * Field yang di-aggregate.
+     * Bisa string (main table) atau qualified dengan alias.
+     */
+    field: string | {
+        tableAlias: string;
+        field: string;
+    };
+    /**
+     * Alias hasil aggregate (wajib, karena tidak bisa pakai nama field asli).
+     */
+    as: string;
+    /**
+     * Filter khusus untuk aggregate ini (misal hanya transaksi cash).
+     * Opsional — jarang dipakai tapi powerful.
+     */
+    filter?: FilterExpression;
+}
+/**
+ * Group by specification — field qualified.
+ */
+export interface GroupBySpec {
+    field: string | {
+        tableAlias: string;
+        field: string;
+    };
+}
+/**
+ * Having condition — sama seperti filter, tapi untuk aggregate.
+ */
+export type HavingExpression = FilterExpression;
+/**
+ * Supported primitive column types (logical, not physical).
+ * Actual DDL mapping is adapter-specific.
+ */
+export type ColumnType = 'string' | 'string[]' | 'number' | 'boolean' | 'date' | 'json';
+/**
+ * Literal values only — no functions, no raw SQL, no objects with methods.
+ * Ensures safe parameter binding across all databases.
+ */
+export type LiteralValue = string | number | boolean | Date | null | LiteralValue[] | {
+    [key: string]: LiteralValue;
+};
+/**
+ * Value expression: only two safe forms — column reference or literal.
+ * No raw strings, no arbitrary functions.
+ */
+export type ValueExpression = {
+    type: 'column';
+    tableAlias?: string;
+    field: string;
+} | {
+    type: 'literal';
+    value: LiteralValue;
+};
+/**
+ * Standard SQL operators supported by all major databases.
+ * Note: Behavior of 'LIKE' (case sensitivity) is DB-dependent — use 'likeMode' to control intent.
+ */
+export type Operator = '=' | '!=' | '<' | '<=' | '>' | '>=' | 'IN' | 'NOT IN' | 'LIKE' | 'IS NULL' | 'IS NOT NULL' | 'BETWEEN';
+/**
+ * Explicit form: full control, join-aware, type-safe.
+ * Recommended when:
+ * - Comparing column vs column (e.g., u.id = o.user_id)
+ * - Need precise alias control
+ * - Building complex queries
+ */
+export interface ExplicitFieldCondition {
+    left: ValueExpression;
+    operator: Operator;
+    right: ValueExpression;
+    likeMode?: 'default' | 'case-sensitive' | 'case-insensitive';
+}
+/**
+ * Simple form: concise, intuitive, main-table focused.
+ * Recommended when:
+ * - Filtering on main table columns
+ * - Quick equality/LIKE checks
+ * - Developer prefers minimal syntax
+ */
+export interface SimpleFieldCondition {
+    field: string;
+    operator?: Operator;
+    value: LiteralValue;
+    alias?: string;
+    likeMode?: 'default' | 'case-sensitive' | 'case-insensitive';
+}
+export interface BetweenCondition {
+    field: string;
+    operator: 'BETWEEN';
+    value: [LiteralValue, LiteralValue];
+    alias?: string;
+}
+/**
+ * Unified field condition — both forms are first-class.
+ */
+export type FieldCondition = ExplicitFieldCondition | SimpleFieldCondition | BetweenCondition;
+/**
+ * Shorthand for common AND-equality filters: { status: 'active', role: 'admin' }.
+ * Syntactic sugar — will be expanded to AND of FieldCondition during query building.
+ * Must be plain object with string keys and LiteralValue values.
+ */
+export type ShorthandCondition = Record<string, LiteralValue>;
+/**
+ * Recursive filter composition.
+ */
+export interface AndNode {
+    and: FilterExpression[];
+}
+export interface OrNode {
+    or: FilterExpression[];
+}
+/**
+ * Unified filter expression type.
+ * Order matters: more specific types first to avoid overlap in type narrowing.
+ */
+export type FilterExpression = FieldCondition | ShorthandCondition | AndNode | OrNode;
+/**
+ * Canonical join subset for cross-runtime compatibility.
+ *
+ * Reason:
+ * - `ofpos-host app` commonly uses SQLite as local DB engine.
+ * - SQLite does not support RIGHT/FULL JOIN across standard adapters.
+ * - `ofpos-shared-core` contract must remain portable and deterministic.
+ *
+ * If an implementer needs RIGHT/FULL behavior, it must be rewritten using
+ * equivalent INNER/LEFT patterns in domain/query design.
+ */
+export type JoinType = 'inner' | 'left';
+/**
+ * A single join condition — always compares two ValueExpression.
+ * At least one condition is required per join.
+ */
+export interface JoinCondition {
+    left: ValueExpression;
+    operator: Operator;
+    right: ValueExpression;
+}
+/**
+ * Join definition.
+ * alias is REQUIRED to avoid ambiguity and injection via auto-generated aliases.
+ */
+export interface JoinDefinition {
+    table: string;
+    alias: string;
+    type?: JoinType;
+    conditions: JoinCondition[];
+}
+/**
+ * Sort specification — fully qualified field.
+ */
+export interface SortSpec {
+    field: {
+        tableAlias: string;
+        field: string;
+    } | string;
+    direction: 'asc' | 'desc';
+}
+export type IncludeSpec = string[] | {
+    [key: string]: true | IncludeSpec;
+};
+export interface QueryOptions {
+    /**
+     * Select specific fields per alias.
+     * e.g. { t0: ['id', 'name'], p: ['role'] }
+     * If omitted, selects all fields from main table (and joined tables if joins exist).
+     */
+    fields?: {
+        [tableAlias: string]: string[];
+    };
+    /**
+     * Filter conditions — root node.
+     */
+    filters?: FilterExpression;
+    /**
+     * Sort specifications.
+     */
+    sort?: SortSpec[];
+    /**
+     * Pagination.
+     */
+    limit?: number;
+    offset?: number;
+    /**
+     * Joins to include.
+     */
+    joins?: JoinDefinition[];
+    /**
+     * Aggregation — jika ada, query berubah jadi SELECT dengan aggregate.
+     * Jika digunakan, `fields` akan diabaikan (kecuali untuk GROUP BY).
+     */
+    aggregates?: AggregateSpec[];
+    /**
+     * GROUP BY — wajib jika ada aggregates.
+     */
+    groupBy?: GroupBySpec[];
+    /**
+     * HAVING — filter setelah GROUP BY.
+     */
+    having?: HavingExpression;
+    /**
+     * Jika tidak di isi maka mainAlias = 't0'
+     */
+    mainAlias?: string;
+    include?: IncludeSpec;
+}
+export interface ColumnRelation {
+    table: string;
+    foreignKey?: string;
+    type: 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
+    via?: string;
+    onDelete?: 'CASCADE' | 'SET NULL';
+    pivotLocalKey?: string;
+    /** Hanya untuk many-to-many – nama kolom di pivot yang nunjuk ke tabel target */
+    pivotForeignKey?: string;
+}
+export interface PolymorphicRelation {
+    typeField: string;
+    idField: string;
+    types: Record<string, {
+        table: string;
+        foreignKey?: string;
+    }>;
+}
+export interface ColumnDefinition {
+    name: string;
+    type: ColumnType;
+    enum?: LiteralValue[];
+    isOptional?: boolean;
+    isIndexed?: boolean;
+    relation?: ColumnRelation;
+    isFullTextSearchable?: boolean;
+    isPrimarySearchKey?: boolean;
+    notes?: string;
+}
+export interface TableSchema {
+    name: string;
+    columns: ColumnDefinition[];
+    skipMetadataColumns?: boolean;
+    polymorphic?: PolymorphicRelation[];
+    notes?: string;
+}
+export interface DbSchema {
+    version: number;
+    tables: TableSchema[];
+}
+export interface DbAdapter {
+    getSchemaVersion(): Promise<number>;
+    setSchemaVersion(version: number): Promise<void>;
+    addTable(table: TableSchema): Promise<void>;
+    addColumn(table: string, column: ColumnDefinition): Promise<void>;
+    /**
+     * Retrieve a single record by primary key `id`.
+     * `idOrOptions` support either an ID string or full QueryOptions
+     */
+    get<T>(table: string, idOrOptions: string | QueryOptions): Promise<T | null>;
+    /**
+     * Query records with filters, joins, sort, pagination.
+     * Result shape depends on `fields` and `joins`.
+     */
+    query<T>(table: string, options?: QueryOptions): Promise<T[]>;
+    /**
+     * Insert a single record.
+     * Keys must be valid column names; values must be LiteralValue.
+     */
+    create<T>(table: string, data: Partial<Record<string, LiteralValue>>): Promise<T>;
+    /**
+     * Update a record by `id`.
+     */
+    update<T>(table: string, id: string, updates: Partial<Record<string, LiteralValue>>): Promise<T>;
+    /**
+     * Delete a record by `id`.
+     */
+    delete(table: string, id: string): Promise<void>;
+    bulkCreate<T>(table: string, rows: Array<Partial<Record<string, LiteralValue>>>): Promise<T[]>;
+    bulkUpdate<T>(table: string, rows: Array<{
+        id: string;
+        updates: Partial<Record<string, LiteralValue>>;
+    }>): Promise<T[]>;
+    /**
+     * Jalankan callback dalam satu transaksi SQLite.
+     * Jika callback throw error atau return Promise reject → otomatis ROLLBACK.
+     * Jika sukses → COMMIT.
+     * Mendukung async/await di dalam callback (penting untuk domain logic yang kompleks).
+     */
+    transaction<T>(callback: (tx: this) => Promise<T>): Promise<T>;
+}

package/dist/ports/PlatformAdapter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * PlatformAdapter menyediakan abstraksi operasi platform-spesifik.
+ * Kontrak ini domain-agnostic.
+ */
+export interface PlatformAdapter {
+    getEnvVar(key: string): string | undefined;
+    isOnline(): boolean;
+    hashPin(pin: string): Promise<string>;
+    verifyPin(pin: string, hashedPin: string): Promise<boolean>;
+}
+/**
+ * Default implementation untuk fase skeleton.
+ * Catatan: implementasi ini netral untuk fase skeleton dan dapat dioverride host.
+ */
+export declare class DefaultPlatformAdapter implements PlatformAdapter {
+    constructor(_context?: unknown);
+    getEnvVar(key: string): string | undefined;
+    isOnline(): boolean;
+    hashPin(pin: string): Promise<string>;
+    verifyPin(pin: string, hashedPin: string): Promise<boolean>;
+}

package/dist/ports/StorageAdapter.d.ts

@@ -0,0 +1,5 @@
+export interface StorageAdapter {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+}

package/dist/runtime/CoreRuntime.d.ts

@@ -0,0 +1,91 @@
+import type { LoggerAdapter } from '../contracts/LoggerAdapter';
+import type { HttpAdapter } from '../contracts/HttpAdapter';
+import type { HttpRetryPolicy } from '../contracts/HttpRetryPolicy';
+import type { SocketAdapter } from '../contracts/SocketAdapter';
+import type { EncryptionAdapter } from '../contracts/EncryptionAdapter';
+import type { ChecksumAdapter } from '../contracts/ChecksumPrimitives';
+import type { ActivityRecord, ActivitySink } from '../contracts/ActivitySink';
+import type { DbAdapter } from '../ports/DbAdapter';
+import type { PlatformAdapter } from '../ports/PlatformAdapter';
+export type AdapterFactory<TAdapter> = (runtime: CoreRuntime<any, any>) => TAdapter;
+export interface CoreAdapterRegistryOptions {
+    platformAdapter?: AdapterFactory<PlatformAdapter>;
+    dbAdapter?: AdapterFactory<DbAdapter>;
+    loggerAdapter?: AdapterFactory<LoggerAdapter>;
+    httpAdapter?: AdapterFactory<HttpAdapter>;
+    httpRetryPolicy?: AdapterFactory<HttpRetryPolicy>;
+    socketAdapter?: AdapterFactory<SocketAdapter>;
+    encryptionAdapter?: AdapterFactory<EncryptionAdapter>;
+    checksumAdapter?: AdapterFactory<ChecksumAdapter>;
+    activitySink?: AdapterFactory<ActivitySink>;
+    extensions?: Record<string, AdapterFactory<unknown>>;
+}
+export declare class CoreAdapterRegistry {
+    readonly platformAdapter?: PlatformAdapter;
+    readonly dbAdapter?: DbAdapter;
+    readonly loggerAdapter?: LoggerAdapter;
+    readonly httpAdapter?: HttpAdapter;
+    readonly httpRetryPolicy: HttpRetryPolicy;
+    readonly socketAdapter?: SocketAdapter;
+    readonly encryptionAdapter?: EncryptionAdapter;
+    readonly checksumAdapter: ChecksumAdapter;
+    readonly activitySink: ActivitySink;
+    private readonly extensions;
+    constructor(runtime: CoreRuntime<any, any>, options: CoreAdapterRegistryOptions);
+    getExtension<TValue>(name: string): TValue | undefined;
+    clear(): void;
+}
+export interface CoreRuntimeStartOptions {
+    runMigrations?: boolean;
+    useSeedData?: boolean;
+}
+export interface CoreRuntimeHooks<TDomainServices, TIntegrationServices> {
+    createDomainServices?: (runtime: CoreRuntime<TDomainServices, TIntegrationServices>) => Promise<TDomainServices> | TDomainServices;
+    createIntegrationServices?: (runtime: CoreRuntime<TDomainServices, TIntegrationServices>) => Promise<TIntegrationServices> | TIntegrationServices;
+    runMigrations?: (runtime: CoreRuntime<TDomainServices, TIntegrationServices>) => Promise<void>;
+    runSeed?: (runtime: CoreRuntime<TDomainServices, TIntegrationServices>) => Promise<void>;
+    onInit?: (runtime: CoreRuntime<TDomainServices, TIntegrationServices>) => Promise<void>;
+    onStop?: (runtime: CoreRuntime<TDomainServices, TIntegrationServices>) => Promise<void>;
+}
+export declare class CoreRuntime<TDomainServices = unknown, TIntegrationServices = unknown> {
+    private correlationCounter;
+    private started;
+    private pluginsLoaded;
+    private pendingPlugins;
+    private hooks;
+    registry?: CoreAdapterRegistry;
+    domainServices?: TDomainServices;
+    integrationServices?: TIntegrationServices;
+    static builder<TDomainServices = unknown, TIntegrationServices = unknown>(): CoreRuntimeBuilder<TDomainServices, TIntegrationServices>;
+    setHooks(hooks: Partial<CoreRuntimeHooks<TDomainServices, TIntegrationServices>>): void;
+    use(name: string, init: (runtime: CoreRuntime<TDomainServices, TIntegrationServices>) => Promise<void>, deps?: string[]): this;
+    init(options?: CoreRuntimeStartOptions): Promise<void>;
+    start(options?: CoreRuntimeStartOptions): Promise<void>;
+    stop(): Promise<void>;
+    reset(): Promise<void>;
+    restart(): Promise<void>;
+    isStarted(): boolean;
+    createCorrelationId(prefix?: string): string;
+    logInfo(message: string, context?: Record<string, unknown>): void;
+    logWarn(message: string, context?: Record<string, unknown>): void;
+    logError(error: unknown, context?: Record<string, unknown>): void;
+    emitActivity(record: ActivityRecord): Promise<void>;
+    private resolvePluginLevels;
+}
+export declare class CoreRuntimeBuilder<TDomainServices = unknown, TIntegrationServices = unknown> {
+    private readonly runtime;
+    private adapterOptions;
+    private hooks;
+    withPlatformAdapter(factory: AdapterFactory<PlatformAdapter>): this;
+    withDbAdapter(factory: AdapterFactory<DbAdapter>): this;
+    withHttpAdapter(factory: AdapterFactory<HttpAdapter>): this;
+    withHttpRetryPolicy(factory: AdapterFactory<HttpRetryPolicy>): this;
+    withSocketAdapter(factory: AdapterFactory<SocketAdapter>): this;
+    withEncryptionAdapter(factory: AdapterFactory<EncryptionAdapter>): this;
+    withChecksumAdapter(factory: AdapterFactory<ChecksumAdapter>): this;
+    withActivitySink(factory: AdapterFactory<ActivitySink>): this;
+    withLoggerAdapter(factory: AdapterFactory<LoggerAdapter>): this;
+    withExtension(name: string, factory: AdapterFactory<unknown>): this;
+    withHooks(hooks: Partial<CoreRuntimeHooks<TDomainServices, TIntegrationServices>>): this;
+    build(): CoreRuntime<TDomainServices, TIntegrationServices>;
+}

package/dist/runtime/createStore.d.ts

@@ -0,0 +1,11 @@
+export type StoreListener<T> = (state: T, previousState: T) => void;
+export interface ReadonlyStore<T> {
+    getState(): T;
+    subscribe(listener: StoreListener<T>): () => void;
+}
+export interface Store<T extends object> extends ReadonlyStore<T> {
+    setState(nextState: Partial<T> | ((state: T) => T)): T;
+    reset(nextState?: T): T;
+}
+export declare function createStore<T extends object>(initialState: T): Store<T>;
+export declare function asReadonlyStore<T>(store: ReadonlyStore<T>): ReadonlyStore<T>;

package/dist/testing/DbAdapterContractHarness.d.ts

@@ -0,0 +1,5 @@
+import type { DbAdapter } from '../ports/DbAdapter';
+export interface DbAdapterContractHarnessOptions {
+    prefix?: string;
+}
+export declare function runDbAdapterContractHarness(adapter: DbAdapter, options?: DbAdapterContractHarnessOptions): Promise<void>;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "ofcore",
+  "version": "0.1.0-alpha.0",
+  "description": "Lightweight runtime core for offline-first TypeScript apps.",
+  "author": {
+    "name": "Agus Made",
+    "email": "krisnaparta@gmail.com"
+  },
+  "private": false,
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "npm run clean && tsc -b && node esbuild.config.js",
+    "bundle": "node esbuild.config.js",
+    "verify:contract": "node ./scripts/verify-contract-surface.js",
+    "verify:surface": "node ./scripts/verify-contract-surface.js",
+    "verify:logic": "node ./scripts/verify-logic-behavior.js && node ./scripts/verify-dbadapter-harness.js && node ./scripts/verify-core-runtime.js && node ./scripts/verify-store.js && node ./scripts/verify-adapter-conformance.js && node ./scripts/verify-adapter-default-vs-override.js",
+    "verify:adapter-conformance": "node ./scripts/verify-adapter-conformance.js",
+    "verify:adapter-default-vs-override": "node ./scripts/verify-adapter-default-vs-override.js",
+    "verify:dbadapter-harness": "node ./scripts/verify-dbadapter-harness.js",
+    "verify:core-runtime": "node ./scripts/verify-core-runtime.js",
+    "verify:store": "node ./scripts/verify-store.js",
+    "ci:check": "npm run build && npm run verify:contract && npm run verify:logic",
+    "prepublishOnly": "npm run ci:check"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.11",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.9.3"
+  }
+}