@comake/skl-js-engine 1.4.3 → 1.5.1

package/dist/SklEngineOptions.d.ts

@@ -1,5 +1,24 @@
 import type { SparqlQueryAdapterOptions } from './storage/query-adapter/sparql/SparqlQueryAdapterOptions';
 import type { Callbacks } from './util/Types';
+export declare type ReadCacheOperation = 'find' | 'findBy' | 'findAll' | 'count';
+export interface ReadCacheStore {
+    get: (key: string) => Promise<unknown | undefined>;
+    set: (key: string, value: unknown, ttlMs: number) => Promise<void>;
+    delete?: (key: string) => Promise<void>;
+    clear?: () => Promise<void>;
+}
+export interface ReadCachePolicyInput {
+    operation: ReadCacheOperation;
+    args: readonly unknown[];
+    endpointUrl?: string;
+    namespace?: string;
+}
+export interface ReadCachePolicyDecision {
+    cache: boolean;
+    ttlMs?: number;
+    keyHint?: string;
+}
+export declare type ReadCachePolicy = (input: ReadCachePolicyInput) => ReadCachePolicyDecision;
 export declare type SklEngineOptions = SparqlQueryAdapterOptions & {
     /**
      * Callbacks to execute upon events.
@@ -22,5 +41,18 @@ export declare type SklEngineOptions = SparqlQueryAdapterOptions & {
      * The path to the executor script.
      */
     readonly scriptPath?: string;
+    /**
+     * Optional read cache store used for select read operations.
+     * Cache decisions are made by readCachePolicy.
+     */
+    readonly readCache?: ReadCacheStore;
+    /**
+     * Optional policy that decides whether a given read operation should be cached.
+     */
+    readonly readCachePolicy?: ReadCachePolicy;
+    /**
+     * Optional namespace to scope cache keys (for example tenant/account isolation).
+     */
+    readonly readCacheNamespace?: string;
 };
 //# sourceMappingURL=SklEngineOptions.d.ts.map

package/dist/SklEngineOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SklEngineOptions.d.ts","sourceRoot":"","sources":["../src/SklEngineOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0DAA0D,CAAC;AAC1G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,oBAAY,gBAAgB,GAAG,yBAAyB,GAAG;IACzD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IAChE;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC"}
+{"version":3,"file":"SklEngineOptions.d.ts","sourceRoot":"","sources":["../src/SklEngineOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0DAA0D,CAAC;AAC1G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,oBAAY,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACnD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,oBAAY,eAAe,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,uBAAuB,CAAC;AAEvF,oBAAY,gBAAgB,GAAG,yBAAyB,GAAG;IACzD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IAChE;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC,CAAC"}

package/dist/SklEngineOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"SklEngineOptions.js","sourceRoot":"","sources":["../src/SklEngineOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { SparqlQueryAdapterOptions } from './storage/query-adapter/sparql/SparqlQueryAdapterOptions';\nimport type { Callbacks } from './util/Types';\n\nexport type SklEngineOptions = SparqlQueryAdapterOptions & {\n  /**\n   * Callbacks to execute upon events.\n   */\n  readonly callbacks?: Callbacks;\n  /**\n   * Manually defined functions which can be used in mappings.\n   */\n  readonly functions?: Record<string, (args: any | any[]) => any>;\n  /**\n   * When true, disables validation of verb parameters and return values according to schemas\n   */\n  readonly disableValidation?: boolean;\n  /**\n   * An object containing files keyed on their title that can be used in mappings.\n   */\n  readonly inputFiles?: Record<string, string>;\n\n  readonly debugMode?: boolean;\n\n  /**\n   * The path to the executor script.\n   */\n  readonly scriptPath?: string;\n};\n"]}
+{"version":3,"file":"SklEngineOptions.js","sourceRoot":"","sources":["../src/SklEngineOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { SparqlQueryAdapterOptions } from './storage/query-adapter/sparql/SparqlQueryAdapterOptions';\nimport type { Callbacks } from './util/Types';\n\nexport type ReadCacheOperation = 'find' | 'findBy' | 'findAll' | 'count';\n\nexport interface ReadCacheStore {\n  get: (key: string) => Promise<unknown | undefined>;\n  set: (key: string, value: unknown, ttlMs: number) => Promise<void>;\n  delete?: (key: string) => Promise<void>;\n  clear?: () => Promise<void>;\n}\n\nexport interface ReadCachePolicyInput {\n  operation: ReadCacheOperation;\n  args: readonly unknown[];\n  endpointUrl?: string;\n  namespace?: string;\n}\n\nexport interface ReadCachePolicyDecision {\n  cache: boolean;\n  ttlMs?: number;\n  keyHint?: string;\n}\n\nexport type ReadCachePolicy = (input: ReadCachePolicyInput) => ReadCachePolicyDecision;\n\nexport type SklEngineOptions = SparqlQueryAdapterOptions & {\n  /**\n   * Callbacks to execute upon events.\n   */\n  readonly callbacks?: Callbacks;\n  /**\n   * Manually defined functions which can be used in mappings.\n   */\n  readonly functions?: Record<string, (args: any | any[]) => any>;\n  /**\n   * When true, disables validation of verb parameters and return values according to schemas\n   */\n  readonly disableValidation?: boolean;\n  /**\n   * An object containing files keyed on their title that can be used in mappings.\n   */\n  readonly inputFiles?: Record<string, string>;\n\n  readonly debugMode?: boolean;\n\n  /**\n   * The path to the executor script.\n   */\n  readonly scriptPath?: string;\n\n  /**\n   * Optional read cache store used for select read operations.\n   * Cache decisions are made by readCachePolicy.\n   */\n  readonly readCache?: ReadCacheStore;\n\n  /**\n   * Optional policy that decides whether a given read operation should be cached.\n   */\n  readonly readCachePolicy?: ReadCachePolicy;\n\n  /**\n   * Optional namespace to scope cache keys (for example tenant/account isolation).\n   */\n  readonly readCacheNamespace?: string;\n};\n"]}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './hooks/types';
 export * from './JsExecutor';
 export * from './mapping/Mapper';
 export * from './SklEngine';
+export * from './SklEngineOptions';
 export * from './storage/FindOperator';
 export * from './storage/FindOptionsTypes';
 export * from './storage/operator/And';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,WAAW,IAAI,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrF,cAAc,eAAe,CAAC;AAE9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAE5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,2EAA2E,CAAC;AAC1F,cAAc,2EAA2E,CAAC;AAE1F,cAAc,mDAAmD,CAAC;AAClE,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,CAAC;AACnE,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,WAAW,IAAI,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrF,cAAc,eAAe,CAAC;AAE9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AAEnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAE5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,2EAA2E,CAAC;AAC1F,cAAc,2EAA2E,CAAC;AAE1F,cAAc,mDAAmD,CAAC;AAClE,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,CAAC;AACnE,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -28,6 +28,7 @@ __exportStar(require("./hooks/types"), exports);
 __exportStar(require("./JsExecutor"), exports);
 __exportStar(require("./mapping/Mapper"), exports);
 __exportStar(require("./SklEngine"), exports);
+__exportStar(require("./SklEngineOptions"), exports);
 // Storage
 __exportStar(require("./storage/FindOperator"), exports);
 __exportStar(require("./storage/FindOptionsTypes"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,UAAU;AACV,8CAA4B;AAC5B,2DAAwF;AAA/E,wHAAA,kBAAkB,OAAA;AAC3B,mDAAqF;AAA5E,uGAAA,WAAW,OAAY;AAAE,yGAAA,UAAU,OAAA;AAAE,wGAAA,SAAS,OAAA;AACvD,gDAA8B;AAC9B,gBAAgB;AAChB,+CAA6B;AAC7B,mDAAiC;AACjC,8CAA4B;AAC5B,UAAU;AACV,yDAAuC;AACvC,6DAA2C;AAC3C,yDAAuC;AACvC,8DAA4C;AAC5C,mBAAmB;AACnB,2DAAyC;AACzC,4DAA0C;AAC1C,iEAA+C;AAC/C,wEAAsD;AACtD,wDAAsC;AACtC,6DAA2C;AAC3C,iEAA+C;AAC/C,qEAAmD;AACnD,0EAAwD;AACxD,8DAA4C;AAC5C,qEAAmD;AACnD,yDAAuC;AACvC,mEAAiD;AACjD,wDAAsC;AACtC,8DAA4C;AAC5C,kEAAgD;AAChD,oEAAkD;AAClD,uEAAqD;AACrD,4GAA0F;AAC1F,4GAA0F;AAC1F,iBAAiB;AACjB,oFAAkE;AAClE,oFAAkE;AAClE,qFAAmE;AACnE,mFAAiE;AACjE,OAAO;AACP,oDAAkC;AAClC,+CAA6B;AAC7B,8CAA4B;AAC5B,6DAA2C","sourcesContent":["// Mapping\nexport * from './constants';\nexport { customCapabilities, type CustomCapabilityHandler } from './customCapabilities';\nexport { globalHooks as SklHooks, HookStages, HookTypes } from './hooks/globalHooks';\nexport * from './hooks/types';\n// Code Executor\nexport * from './JsExecutor';\nexport * from './mapping/Mapper';\nexport * from './SklEngine';\n// Storage\nexport * from './storage/FindOperator';\nexport * from './storage/FindOptionsTypes';\nexport * from './storage/operator/And';\nexport * from './storage/operator/Contains';\n// Storage/Operator\nexport * from './storage/operator/Equal';\nexport * from './storage/operator/Exists';\nexport * from './storage/operator/GreaterThan';\nexport * from './storage/operator/GreaterThanOrEqual';\nexport * from './storage/operator/In';\nexport * from './storage/operator/Inverse';\nexport * from './storage/operator/InversePath';\nexport * from './storage/operator/InverseRelation';\nexport * from './storage/operator/InverseRelationOrder';\nexport * from './storage/operator/LessThan';\nexport * from './storage/operator/LessThanOrEqual';\nexport * from './storage/operator/Not';\nexport * from './storage/operator/OneOrMorePath';\nexport * from './storage/operator/Or';\nexport * from './storage/operator/Sequence';\nexport * from './storage/operator/SequencePath';\nexport * from './storage/operator/ZeroOrMorePath';\nexport * from './storage/query-adapter/QueryAdapter';\nexport * from './storage/query-adapter/sparql/query-executor/InMemorySparqlQueryExecutor';\nexport * from './storage/query-adapter/sparql/query-executor/SparqlEndpointQueryExecutor';\n// Storage/Sparql\nexport * from './storage/query-adapter/sparql/SparqlQueryAdapter';\nexport * from './storage/query-adapter/sparql/SparqlQueryBuilder';\nexport * from './storage/query-adapter/sparql/SparqlUpdateBuilder';\nexport * from './storage/query-adapter/sparql/VariableGenerator';\n// Util\nexport * from './util/TripleUtil';\nexport * from './util/Types';\nexport * from './util/Util';\nexport * from './util/Vocabularies/helper';\n\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,UAAU;AACV,8CAA4B;AAC5B,2DAAwF;AAA/E,wHAAA,kBAAkB,OAAA;AAC3B,mDAAqF;AAA5E,uGAAA,WAAW,OAAY;AAAE,yGAAA,UAAU,OAAA;AAAE,wGAAA,SAAS,OAAA;AACvD,gDAA8B;AAC9B,gBAAgB;AAChB,+CAA6B;AAC7B,mDAAiC;AACjC,8CAA4B;AAC5B,qDAAmC;AACnC,UAAU;AACV,yDAAuC;AACvC,6DAA2C;AAC3C,yDAAuC;AACvC,8DAA4C;AAC5C,mBAAmB;AACnB,2DAAyC;AACzC,4DAA0C;AAC1C,iEAA+C;AAC/C,wEAAsD;AACtD,wDAAsC;AACtC,6DAA2C;AAC3C,iEAA+C;AAC/C,qEAAmD;AACnD,0EAAwD;AACxD,8DAA4C;AAC5C,qEAAmD;AACnD,yDAAuC;AACvC,mEAAiD;AACjD,wDAAsC;AACtC,8DAA4C;AAC5C,kEAAgD;AAChD,oEAAkD;AAClD,uEAAqD;AACrD,4GAA0F;AAC1F,4GAA0F;AAC1F,iBAAiB;AACjB,oFAAkE;AAClE,oFAAkE;AAClE,qFAAmE;AACnE,mFAAiE;AACjE,OAAO;AACP,oDAAkC;AAClC,+CAA6B;AAC7B,8CAA4B;AAC5B,6DAA2C","sourcesContent":["// Mapping\nexport * from './constants';\nexport { customCapabilities, type CustomCapabilityHandler } from './customCapabilities';\nexport { globalHooks as SklHooks, HookStages, HookTypes } from './hooks/globalHooks';\nexport * from './hooks/types';\n// Code Executor\nexport * from './JsExecutor';\nexport * from './mapping/Mapper';\nexport * from './SklEngine';\nexport * from './SklEngineOptions';\n// Storage\nexport * from './storage/FindOperator';\nexport * from './storage/FindOptionsTypes';\nexport * from './storage/operator/And';\nexport * from './storage/operator/Contains';\n// Storage/Operator\nexport * from './storage/operator/Equal';\nexport * from './storage/operator/Exists';\nexport * from './storage/operator/GreaterThan';\nexport * from './storage/operator/GreaterThanOrEqual';\nexport * from './storage/operator/In';\nexport * from './storage/operator/Inverse';\nexport * from './storage/operator/InversePath';\nexport * from './storage/operator/InverseRelation';\nexport * from './storage/operator/InverseRelationOrder';\nexport * from './storage/operator/LessThan';\nexport * from './storage/operator/LessThanOrEqual';\nexport * from './storage/operator/Not';\nexport * from './storage/operator/OneOrMorePath';\nexport * from './storage/operator/Or';\nexport * from './storage/operator/Sequence';\nexport * from './storage/operator/SequencePath';\nexport * from './storage/operator/ZeroOrMorePath';\nexport * from './storage/query-adapter/QueryAdapter';\nexport * from './storage/query-adapter/sparql/query-executor/InMemorySparqlQueryExecutor';\nexport * from './storage/query-adapter/sparql/query-executor/SparqlEndpointQueryExecutor';\n// Storage/Sparql\nexport * from './storage/query-adapter/sparql/SparqlQueryAdapter';\nexport * from './storage/query-adapter/sparql/SparqlQueryBuilder';\nexport * from './storage/query-adapter/sparql/SparqlUpdateBuilder';\nexport * from './storage/query-adapter/sparql/VariableGenerator';\n// Util\nexport * from './util/TripleUtil';\nexport * from './util/Types';\nexport * from './util/Util';\nexport * from './util/Vocabularies/helper';\n\n"]}

package/dist/storage/FindOptionsTypes.d.ts

@@ -14,6 +14,7 @@ export interface FindOneOptions {
     skipFraming?: boolean;
     group?: Variable;
     entitySelectVariable?: Variable;
+    bypassCache?: boolean;
 }
 export declare type FindOptionsRelationsValue = boolean | FindOptionsRelations | FindOperator<InverseRelationOperatorValue, 'inverseRelation'>;
 export declare type FindOptionsRelations = {
@@ -49,7 +50,8 @@ export interface FindOptionsWhere {
     binds?: BindPattern[];
     and?: FindOptionsWhere[];
     or?: FindOptionsWhere[];
-    [k: string]: FindOptionsWhereField | BindPattern[] | FindOptionsWhere[] | undefined;
+    bypassCache?: boolean;
+    [k: string]: FindOptionsWhereField | BindPattern[] | FindOptionsWhere[] | boolean | undefined;
 }
 export interface SubQuery {
     select: Variable[];
@@ -72,5 +74,6 @@ export interface FindCountOptions {
     relations?: FindOptionsRelations;
     order?: FindOptionsOrder;
     offset?: number;
+    bypassCache?: boolean;
 }
 //# sourceMappingURL=FindOptionsTypes.d.ts.map

package/dist/storage/FindOptionsTypes.d.ts.map

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

package/dist/storage/FindOptionsTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"FindOptionsTypes.js","sourceRoot":"","sources":["../../src/storage/FindOptionsTypes.ts"],"names":[],"mappings":"","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\nimport type { Expression, Variable } from 'sparqljs';\nimport type { OrArray, JSONArray, JSONObject } from '../util/Types';\nimport type { FindOperator } from './FindOperator';\nimport type { InverseRelationOperatorValue } from './operator/InverseRelation';\nimport type { InverseRelationOrderValue } from './operator/InverseRelationOrder';\n\nexport type FindOptionsSelect = string[] | {[key: string]: boolean | FindOptionsSelect };\n\nexport interface FindOneOptions {\n  select?: FindOptionsSelect;\n  where?: FindOptionsWhere;\n  relations?: FindOptionsRelations;\n  order?: FindOptionsOrder;\n  skipFraming?: boolean;\n  group?: Variable;\n  entitySelectVariable?: Variable;\n}\n\nexport type FindOptionsRelationsValue =\n  | boolean\n  | FindOptionsRelations\n  | FindOperator<InverseRelationOperatorValue, 'inverseRelation'>;\n\n// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style\nexport type FindOptionsRelations = {\n  [k: string]: FindOptionsRelationsValue;\n};\n\nexport type FindOptionsOrderValue = 'ASC' | 'DESC' | 'asc' | 'desc' | 1 | -1;\n\nexport type FindOptionsOrder = Record<\nstring,\nFindOptionsOrderValue | FindOperator<InverseRelationOrderValue, 'inverseRelationOrder'>\n>;\n\nexport type FieldPrimitiveValue = boolean | number | string | Date;\n\nexport type JsonValueObject = {\n  '@value': FieldPrimitiveValue | JSONObject | JSONArray;\n  '@type': '@json';\n};\n\nexport type LanguageValueObject = {\n  '@value': string;\n  '@language': string;\n  '@direction': string;\n};\n\nexport type NonJsonValueObject = {\n  '@value': FieldPrimitiveValue;\n  '@type': string;\n};\n\nexport type ValueWhereFieldObject = JsonValueObject | LanguageValueObject | NonJsonValueObject;\n\nexport type FindOptionsWhereField =\n  | OrArray<FieldPrimitiveValue>\n  | ValueWhereFieldObject\n  | FindOptionsWhere\n  | OrArray<FindOperator<any, any>>\n  | BindPattern[];\n\nexport type IdFindOptionsWhereField = string | FindOperator<any, 'in' | 'not' | 'equal' | 'inversePath' | 'contains'>;\n\nexport type TypeFindOptionsWhereField =\n  | string\n  | FindOperator<string | string[] | FindOptionsWhere, 'in' | 'not' | 'equal' | 'inverse' | 'contains'>;\n\nexport interface BindPattern {\n  expression: Expression;\n  variable: Variable;\n}\n\nexport interface FindOptionsWhere {\n  type?: TypeFindOptionsWhereField;\n  id?: IdFindOptionsWhereField;\n  binds?: BindPattern[];\n  and?: FindOptionsWhere[];\n  or?: FindOptionsWhere[];\n  [k: string]: FindOptionsWhereField | BindPattern[] | FindOptionsWhere[] | undefined;\n}\n\n// Add these new types\nexport interface SubQuery {\n  select: Variable[];\n  where: FindOptionsWhere;\n  groupBy?: string[];\n  having?: FindOptionsWhere;\n}\n\nexport interface FindAllOptions extends FindOneOptions {\n  offset?: number;\n  limit?: number;\n  skipHook?: boolean;\n  subQueries?: SubQuery[];\n}\n\nexport interface FindExistsOptions {\n  where?: FindOptionsWhere;\n  relations?: FindOptionsRelations;\n}\n\nexport interface FindCountOptions {\n  where?: FindOptionsWhere;\n  relations?: FindOptionsRelations;\n  order?: FindOptionsOrder;\n  offset?: number;\n}\n"]}
+{"version":3,"file":"FindOptionsTypes.js","sourceRoot":"","sources":["../../src/storage/FindOptionsTypes.ts"],"names":[],"mappings":"","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\nimport type { Expression, Variable } from 'sparqljs';\nimport type { OrArray, JSONArray, JSONObject } from '../util/Types';\nimport type { FindOperator } from './FindOperator';\nimport type { InverseRelationOperatorValue } from './operator/InverseRelation';\nimport type { InverseRelationOrderValue } from './operator/InverseRelationOrder';\n\nexport type FindOptionsSelect = string[] | {[key: string]: boolean | FindOptionsSelect };\n\nexport interface FindOneOptions {\n  select?: FindOptionsSelect;\n  where?: FindOptionsWhere;\n  relations?: FindOptionsRelations;\n  order?: FindOptionsOrder;\n  skipFraming?: boolean;\n  group?: Variable;\n  entitySelectVariable?: Variable;\n  bypassCache?: boolean;\n}\n\nexport type FindOptionsRelationsValue =\n  | boolean\n  | FindOptionsRelations\n  | FindOperator<InverseRelationOperatorValue, 'inverseRelation'>;\n\n// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style\nexport type FindOptionsRelations = {\n  [k: string]: FindOptionsRelationsValue;\n};\n\nexport type FindOptionsOrderValue = 'ASC' | 'DESC' | 'asc' | 'desc' | 1 | -1;\n\nexport type FindOptionsOrder = Record<\nstring,\nFindOptionsOrderValue | FindOperator<InverseRelationOrderValue, 'inverseRelationOrder'>\n>;\n\nexport type FieldPrimitiveValue = boolean | number | string | Date;\n\nexport type JsonValueObject = {\n  '@value': FieldPrimitiveValue | JSONObject | JSONArray;\n  '@type': '@json';\n};\n\nexport type LanguageValueObject = {\n  '@value': string;\n  '@language': string;\n  '@direction': string;\n};\n\nexport type NonJsonValueObject = {\n  '@value': FieldPrimitiveValue;\n  '@type': string;\n};\n\nexport type ValueWhereFieldObject = JsonValueObject | LanguageValueObject | NonJsonValueObject;\n\nexport type FindOptionsWhereField =\n  | OrArray<FieldPrimitiveValue>\n  | ValueWhereFieldObject\n  | FindOptionsWhere\n  | OrArray<FindOperator<any, any>>\n  | BindPattern[];\n\nexport type IdFindOptionsWhereField = string | FindOperator<any, 'in' | 'not' | 'equal' | 'inversePath' | 'contains'>;\n\nexport type TypeFindOptionsWhereField =\n  | string\n  | FindOperator<string | string[] | FindOptionsWhere, 'in' | 'not' | 'equal' | 'inverse' | 'contains'>;\n\nexport interface BindPattern {\n  expression: Expression;\n  variable: Variable;\n}\n\nexport interface FindOptionsWhere {\n  type?: TypeFindOptionsWhereField;\n  id?: IdFindOptionsWhereField;\n  binds?: BindPattern[];\n  and?: FindOptionsWhere[];\n  or?: FindOptionsWhere[];\n  bypassCache?: boolean;\n  [k: string]: FindOptionsWhereField | BindPattern[] | FindOptionsWhere[] | boolean | undefined;\n}\n\n// Add these new types\nexport interface SubQuery {\n  select: Variable[];\n  where: FindOptionsWhere;\n  groupBy?: string[];\n  having?: FindOptionsWhere;\n}\n\nexport interface FindAllOptions extends FindOneOptions {\n  offset?: number;\n  limit?: number;\n  skipHook?: boolean;\n  subQueries?: SubQuery[];\n}\n\nexport interface FindExistsOptions {\n  where?: FindOptionsWhere;\n  relations?: FindOptionsRelations;\n}\n\nexport interface FindCountOptions {\n  where?: FindOptionsWhere;\n  relations?: FindOptionsRelations;\n  order?: FindOptionsOrder;\n  offset?: number;\n  bypassCache?: boolean;\n}\n"]}

package/dist/util/ReadCacheHelper.d.ts

@@ -0,0 +1,14 @@
+import type { ReadCacheOperation } from '../SklEngineOptions';
+export interface BuildReadCacheKeyInput {
+    operation: ReadCacheOperation;
+    args: readonly unknown[];
+    endpointUrl?: string;
+    namespace?: string;
+    keyHint?: string;
+}
+export declare function buildReadCacheKey(input: BuildReadCacheKeyInput): string;
+export declare class ReadCacheSingleflight {
+    private readonly inflight;
+    do<T>(key: string, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=ReadCacheHelper.d.ts.map

package/dist/util/ReadCacheHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadCacheHelper.d.ts","sourceRoot":"","sources":["../../src/util/ReadCacheHelper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CASvE;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEnD,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAiBlE"}

package/dist/util/ReadCacheHelper.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadCacheSingleflight = exports.buildReadCacheKey = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+function stableStringify(value) {
+    if (value === null)
+        return 'null';
+    const valueType = typeof value;
+    if (valueType === 'number' || valueType === 'boolean')
+        return String(value);
+    if (valueType === 'string')
+        return JSON.stringify(value);
+    if (valueType !== 'object') {
+        const serializedPrimitive = JSON.stringify(value);
+        return serializedPrimitive ?? String(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(',')}]`;
+    }
+    const objectValue = value;
+    // eslint-disable-next-line @typescript-eslint/require-array-sort-compare
+    const keys = Object.keys(objectValue).sort();
+    return `{${keys.map((key) => `${JSON.stringify(key)}:${stableStringify(objectValue[key])}`).join(',')}}`;
+}
+function buildReadCacheKey(input) {
+    const keyParts = {
+        namespace: input.namespace ?? '',
+        endpointUrl: input.endpointUrl ?? '',
+        operation: input.operation,
+        keyHint: input.keyHint ?? '',
+        args: input.args
+    };
+    return crypto_1.default.createHash('sha256').update(stableStringify(keyParts)).digest('hex');
+}
+exports.buildReadCacheKey = buildReadCacheKey;
+class ReadCacheSingleflight {
+    constructor() {
+        this.inflight = new Map();
+    }
+    async do(key, fn) {
+        const existing = this.inflight.get(key);
+        if (existing) {
+            return existing;
+        }
+        const promise = (async () => {
+            try {
+                return await fn();
+            }
+            finally {
+                this.inflight.delete(key);
+            }
+        })();
+        this.inflight.set(key, promise);
+        return promise;
+    }
+}
+exports.ReadCacheSingleflight = ReadCacheSingleflight;
+//# sourceMappingURL=ReadCacheHelper.js.map

package/dist/util/ReadCacheHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadCacheHelper.js","sourceRoot":"","sources":["../../src/util/ReadCacheHelper.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAW5B,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAElC,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;IAC/B,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5E,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,SAAS,KAAK,QAAQ,EAAE;QAC1B,MAAM,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,mBAAmB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;KAC7C;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACxB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;KACpD;IAED,MAAM,WAAW,GAAG,KAAgC,CAAC;IACrD,yEAAyE;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3G,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,QAAQ,GAAG;QACf,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACpC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;IACF,OAAO,gBAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrF,CAAC;AATD,8CASC;AAED,MAAa,qBAAqB;IAAlC;QACmB,aAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAmBlE,CAAC;IAjBQ,KAAK,CAAC,EAAE,CAAI,GAAW,EAAE,EAAoB;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAA2B,CAAC;QAClE,IAAI,QAAQ,EAAE;YACZ,OAAO,QAAQ,CAAC;SACjB;QAED,MAAM,OAAO,GAAG,CAAC,KAAK,IAAe,EAAE;YACrC,IAAI;gBACF,OAAO,MAAM,EAAE,EAAE,CAAC;aACnB;oBAAS;gBACR,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;aAC3B;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAA2B,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AApBD,sDAoBC","sourcesContent":["import crypto from 'crypto';\nimport type { ReadCacheOperation } from '../SklEngineOptions';\n\nexport interface BuildReadCacheKeyInput {\n  operation: ReadCacheOperation;\n  args: readonly unknown[];\n  endpointUrl?: string;\n  namespace?: string;\n  keyHint?: string;\n}\n\nfunction stableStringify(value: unknown): string {\n  if (value === null) return 'null';\n\n  const valueType = typeof value;\n  if (valueType === 'number' || valueType === 'boolean') return String(value);\n  if (valueType === 'string') return JSON.stringify(value);\n  if (valueType !== 'object') {\n    const serializedPrimitive = JSON.stringify(value);\n    return serializedPrimitive ?? String(value);\n  }\n\n  if (Array.isArray(value)) {\n    return `[${value.map(stableStringify).join(',')}]`;\n  }\n\n  const objectValue = value as Record<string, unknown>;\n  // eslint-disable-next-line @typescript-eslint/require-array-sort-compare\n  const keys = Object.keys(objectValue).sort();\n  return `{${keys.map((key) => `${JSON.stringify(key)}:${stableStringify(objectValue[key])}`).join(',')}}`;\n}\n\nexport function buildReadCacheKey(input: BuildReadCacheKeyInput): string {\n  const keyParts = {\n    namespace: input.namespace ?? '',\n    endpointUrl: input.endpointUrl ?? '',\n    operation: input.operation,\n    keyHint: input.keyHint ?? '',\n    args: input.args\n  };\n  return crypto.createHash('sha256').update(stableStringify(keyParts)).digest('hex');\n}\n\nexport class ReadCacheSingleflight {\n  private readonly inflight = new Map<string, Promise<unknown>>();\n\n  public async do<T>(key: string, fn: () => Promise<T>): Promise<T> {\n    const existing = this.inflight.get(key) as Promise<T> | undefined;\n    if (existing) {\n      return existing;\n    }\n\n    const promise = (async(): Promise<T> => {\n      try {\n        return await fn();\n      } finally {\n        this.inflight.delete(key);\n      }\n    })();\n\n    this.inflight.set(key, promise as Promise<unknown>);\n    return promise;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@comake/skl-js-engine",
-	"version": "1.4.3",
+	"version": "1.5.1",
 	"description": "Standard Knowledge Language Javascript Engine",
 	"keywords": [
 		"skl",

package/src/SklEngine.ts

@@ -34,7 +34,7 @@ import type { ExecutionOptions } from './JsExecutor';
 import type { ICodeExecutor } from './JsExecutor/types';
 import { Logger } from './logger';
 import { Mapper } from './mapping/Mapper';
-import type { SklEngineOptions } from './SklEngineOptions';
+import type { ReadCacheOperation, ReadCachePolicy, ReadCacheStore, SklEngineOptions } from './SklEngineOptions';
 import type { FindOperator } from './storage/FindOperator';
 import type { FindAllOptions, FindOneOptions, FindOptionsWhere } from './storage/FindOptionsTypes';
 import type { GroupByOptions, GroupByResponse } from './storage/GroupOptionTypes';
@@ -48,6 +48,7 @@ import { ZeroOrMorePath } from './storage/operator/ZeroOrMorePath';
 import type { QueryAdapter, RawQueryResult } from './storage/query-adapter/QueryAdapter';
 import { SparqlQueryAdapter } from './storage/query-adapter/sparql/SparqlQueryAdapter';
 import { PerformanceLogger } from './util/PerformanceLogger';
+import { buildReadCacheKey, ReadCacheSingleflight } from './util/ReadCacheHelper';
 // Import './util/safeJsonStringify';
 import type {
   Callbacks,
@@ -82,6 +83,12 @@ export type CapabilityInterface = Record<string, CapabilityHandler>;
 export type MappingResponseOption<T extends boolean> = T extends true ? JSONObject : NodeObject;
 
 export type WriteOptions = { bypassHooks?: boolean };
+const DEFAULT_READ_CACHE_TTL_MS = 60_000;
+const READ_CACHE_ENVELOPE_MARKER = '__sklReadCacheEnvelopeV1';
+type ReadCacheEnvelope<T> = {
+  [READ_CACHE_ENVELOPE_MARKER]: true;
+  value: T;
+};
 
 export class SKLEngine implements SKLEngineInterface {
   private readonly queryAdapter: QueryAdapter;
@@ -94,6 +101,10 @@ export class SKLEngine implements SKLEngineInterface {
   private readonly skdsEndpointUrl: string;
   private readonly scriptPath: string;
   private readonly logger: Logger;
+  private readonly readCache?: ReadCacheStore;
+  private readonly readCachePolicy?: ReadCachePolicy;
+  private readonly readCacheNamespace?: string;
+  private readonly readCacheSingleflight = new ReadCacheSingleflight();
   public constructor(options: SklEngineOptions) {
     this.queryAdapter = new SparqlQueryAdapter(options);
     this.disableValidation = options.disableValidation;
@@ -101,6 +112,9 @@ export class SKLEngine implements SKLEngineInterface {
     this.inputFiles = options.inputFiles;
     this.skdsEndpointUrl = (options as any).endpointUrl;
     this.scriptPath = (options as any).scriptPath;
+    this.readCache = options.readCache;
+    this.readCachePolicy = options.readCachePolicy;
+    this.readCacheNamespace = options.readCacheNamespace;
     if (options.functions) {
       this.functions = Object.fromEntries(
         Object.entries(options.functions).map(([key, func]) => [
@@ -145,21 +159,137 @@ export class SKLEngine implements SKLEngineInterface {
     return await this.queryAdapter.executeRawConstructQuery(query, frame);
   }
 
+  private cloneForReadCache<T>(value: T): T {
+    try {
+      return structuredClone(value);
+    } catch {
+      return value;
+    }
+  }
+
+  private wrapReadCacheValue<T>(value: T): ReadCacheEnvelope<T> {
+    return {
+      [READ_CACHE_ENVELOPE_MARKER]: true,
+      value
+    };
+  }
+
+  private isReadCacheEnvelope<T>(value: unknown): value is ReadCacheEnvelope<T> {
+    if (!value || typeof value !== 'object') {
+      return false;
+    }
+    return (value as Record<string, unknown>)[READ_CACHE_ENVELOPE_MARKER] === true;
+  }
+
+  private stripBypassCacheFromFindOneOptions(options?: FindOneOptions): FindOneOptions | undefined {
+    if (!options) {
+      return options;
+    }
+    const { bypassCache, ...rest } = options;
+    return rest;
+  }
+
+  private stripBypassCacheFromFindAllOptions(options?: FindAllOptions): FindAllOptions | undefined {
+    if (!options) {
+      return options;
+    }
+    const { bypassCache, ...rest } = options;
+    return rest;
+  }
+
+  private stripBypassCacheFromWhere(where?: FindOptionsWhere): FindOptionsWhere | undefined {
+    if (!where) {
+      return where;
+    }
+    const { bypassCache, ...rest } = where;
+    return rest;
+  }
+
+  private async runReadWithCache<T>(params: {
+    operation: ReadCacheOperation;
+    args: readonly unknown[];
+    bypassCache?: boolean;
+    execute: () => Promise<T>;
+  }): Promise<T> {
+    if (params.bypassCache) {
+      return await params.execute();
+    }
+
+    if (!this.readCache || !this.readCachePolicy) {
+      return await params.execute();
+    }
+
+    const policyDecision = this.readCachePolicy({
+      operation: params.operation,
+      args: params.args,
+      endpointUrl: this.skdsEndpointUrl,
+      namespace: this.readCacheNamespace
+    });
+    if (!policyDecision.cache) {
+      return await params.execute();
+    }
+
+    const ttlMs = policyDecision.ttlMs ?? DEFAULT_READ_CACHE_TTL_MS;
+    if (ttlMs <= 0) {
+      return await params.execute();
+    }
+
+    const cacheKey = buildReadCacheKey({
+      operation: params.operation,
+      args: params.args,
+      endpointUrl: this.skdsEndpointUrl,
+      namespace: this.readCacheNamespace,
+      keyHint: policyDecision.keyHint
+    });
+
+    return await this.readCacheSingleflight.do(cacheKey, async() => {
+      try {
+        const cached = await this.readCache?.get(cacheKey);
+        if (cached !== undefined) {
+          if (this.isReadCacheEnvelope<T>(cached)) {
+            return this.cloneForReadCache(cached.value);
+          }
+          return this.cloneForReadCache(cached as T);
+        }
+      } catch (error) {
+        this.logger.debug('Read cache lookup failed; continuing without cache', error as any);
+      }
+
+      const result = await params.execute();
+
+      try {
+        await this.readCache?.set(cacheKey, this.wrapReadCacheValue(this.cloneForReadCache(result)), ttlMs);
+      } catch (error) {
+        this.logger.debug('Read cache write failed; continuing without cache', error as any);
+      }
+
+      return result;
+    });
+  }
+
   public async find(options?: FindOneOptions): Promise<Entity> {
+    const bypassCache = options?.bypassCache;
+    const optionsWithoutBypass = this.stripBypassCacheFromFindOneOptions(options);
+
     return PerformanceLogger.withSpanRoot('SklEngine.find', async() => {
       const context = {
         entities: [],
         operation: 'find',
-        operationParameters: { options },
+        operationParameters: { options: optionsWithoutBypass },
         sklEngine: this
       };
 
       await globalHooks.execute(HookTypes.READ, HookStages.BEFORE, context);
 
       try {
-        const entity = await this.queryAdapter.find(options);
+        const entity = await this.runReadWithCache({
+          operation: 'find',
+          args: [optionsWithoutBypass],
+          bypassCache,
+          execute: async() => await this.queryAdapter.find(optionsWithoutBypass)
+        });
         if (!entity) {
-          throw new Error(`No schema found with fields matching ${JSON.stringify(options)}`);
+          throw new Error(`No schema found with fields matching ${JSON.stringify(optionsWithoutBypass)}`);
         }
 
         const updatedContext = { ...context, entities: [entity]};
@@ -170,31 +300,39 @@ export class SKLEngine implements SKLEngineInterface {
         await globalHooks.execute(HookTypes.READ, HookStages.ERROR, context, error);
         throw error;
       }
-    }, { options });
+    }, { options: optionsWithoutBypass });
   }
 
   public async findBy(where: FindOptionsWhere, notFoundErrorMessage?: string): Promise<Entity> {
+    const bypassCache = where?.bypassCache;
+    const whereWithoutBypass = this.stripBypassCacheFromWhere(where)!;
+
     return PerformanceLogger.withSpanRoot('SklEngine.findBy', async() => {
       const context = {
         entities: [],
         operation: 'findBy',
-        operationParameters: { where },
+        operationParameters: { where: whereWithoutBypass },
         sklEngine: this
       };
       await globalHooks.execute(HookTypes.READ, HookStages.BEFORE, context);
       try {
-        const entity = await this.queryAdapter.findBy(where);
+        const entity = await this.runReadWithCache({
+          operation: 'findBy',
+          args: [whereWithoutBypass, notFoundErrorMessage],
+          bypassCache,
+          execute: async() => await this.queryAdapter.findBy(whereWithoutBypass)
+        });
         if (entity) {
           const updatedContext = { ...context, entities: [entity]};
           await globalHooks.execute(HookTypes.READ, HookStages.AFTER, updatedContext, entity);
           return entity;
         }
-        throw new Error(notFoundErrorMessage ?? `No schema found with fields matching ${JSON.stringify(where)}`);
+        throw new Error(notFoundErrorMessage ?? `No schema found with fields matching ${JSON.stringify(whereWithoutBypass)}`);
       } catch (error: unknown) {
         await globalHooks.execute(HookTypes.READ, HookStages.ERROR, context, error);
         throw error;
       }
-    }, { where });
+    }, { where: whereWithoutBypass });
   }
 
   public async findByIfExists(options: FindOptionsWhere): Promise<Entity | undefined> {
@@ -207,16 +345,24 @@ export class SKLEngine implements SKLEngineInterface {
   }
 
   public async findAll(options?: FindAllOptions): Promise<Entity[]> {
+    const bypassCache = options?.bypassCache;
+    const optionsWithoutBypass = this.stripBypassCacheFromFindAllOptions(options);
+
     return PerformanceLogger.withSpanRoot('SklEngine.findAll', async() => {
       const context = {
         entities: [],
         operation: 'findAll',
-        operationParameters: { options },
+        operationParameters: { options: optionsWithoutBypass },
         sklEngine: this
       };
       await globalHooks.execute(HookTypes.READ, HookStages.BEFORE, context);
       try {
-        const entities = await this.queryAdapter.findAll(options);
+        const entities = await this.runReadWithCache({
+          operation: 'findAll',
+          args: [optionsWithoutBypass],
+          bypassCache,
+          execute: async() => await this.queryAdapter.findAll(optionsWithoutBypass)
+        });
         const updatedContext = { ...context, entities };
         await globalHooks.execute(HookTypes.READ, HookStages.AFTER, updatedContext, entities);
         return entities;
@@ -224,7 +370,7 @@ export class SKLEngine implements SKLEngineInterface {
         await globalHooks.execute(HookTypes.READ, HookStages.ERROR, context, error);
         throw error;
       }
-    }, { options });
+    }, { options: optionsWithoutBypass });
   }
 
   public async groupBy(options: GroupByOptions): Promise<GroupByResponse> {
@@ -274,7 +420,20 @@ export class SKLEngine implements SKLEngineInterface {
   }
 
   public async count(options?: FindAllOptions): Promise<number> {
-    return PerformanceLogger.withSpanRoot('SklEngine.count', async() => this.queryAdapter.count(options), { options });
+    const bypassCache = options?.bypassCache;
+    const optionsWithoutBypass = this.stripBypassCacheFromFindAllOptions(options);
+
+    return PerformanceLogger.withSpanRoot(
+      'SklEngine.count',
+      async() =>
+        await this.runReadWithCache({
+          operation: 'count',
+          args: [optionsWithoutBypass],
+          bypassCache,
+          execute: async() => await this.queryAdapter.count(optionsWithoutBypass)
+        }),
+      { options: optionsWithoutBypass }
+    );
   }
 
   public async save(entity: Entity, options?: WriteOptions): Promise<Entity>;

package/src/SklEngineOptions.ts

@@ -1,6 +1,30 @@
 import type { SparqlQueryAdapterOptions } from './storage/query-adapter/sparql/SparqlQueryAdapterOptions';
 import type { Callbacks } from './util/Types';
 
+export type ReadCacheOperation = 'find' | 'findBy' | 'findAll' | 'count';
+
+export interface ReadCacheStore {
+  get: (key: string) => Promise<unknown | undefined>;
+  set: (key: string, value: unknown, ttlMs: number) => Promise<void>;
+  delete?: (key: string) => Promise<void>;
+  clear?: () => Promise<void>;
+}
+
+export interface ReadCachePolicyInput {
+  operation: ReadCacheOperation;
+  args: readonly unknown[];
+  endpointUrl?: string;
+  namespace?: string;
+}
+
+export interface ReadCachePolicyDecision {
+  cache: boolean;
+  ttlMs?: number;
+  keyHint?: string;
+}
+
+export type ReadCachePolicy = (input: ReadCachePolicyInput) => ReadCachePolicyDecision;
+
 export type SklEngineOptions = SparqlQueryAdapterOptions & {
   /**
    * Callbacks to execute upon events.
@@ -25,4 +49,20 @@ export type SklEngineOptions = SparqlQueryAdapterOptions & {
    * The path to the executor script.
    */
   readonly scriptPath?: string;
+
+  /**
+   * Optional read cache store used for select read operations.
+   * Cache decisions are made by readCachePolicy.
+   */
+  readonly readCache?: ReadCacheStore;
+
+  /**
+   * Optional policy that decides whether a given read operation should be cached.
+   */
+  readonly readCachePolicy?: ReadCachePolicy;
+
+  /**
+   * Optional namespace to scope cache keys (for example tenant/account isolation).
+   */
+  readonly readCacheNamespace?: string;
 };

package/src/index.ts

@@ -7,6 +7,7 @@ export * from './hooks/types';
 export * from './JsExecutor';
 export * from './mapping/Mapper';
 export * from './SklEngine';
+export * from './SklEngineOptions';
 // Storage
 export * from './storage/FindOperator';
 export * from './storage/FindOptionsTypes';

package/src/storage/FindOptionsTypes.ts

@@ -15,6 +15,7 @@ export interface FindOneOptions {
   skipFraming?: boolean;
   group?: Variable;
   entitySelectVariable?: Variable;
+  bypassCache?: boolean;
 }
 
 export type FindOptionsRelationsValue =
@@ -78,7 +79,8 @@ export interface FindOptionsWhere {
   binds?: BindPattern[];
   and?: FindOptionsWhere[];
   or?: FindOptionsWhere[];
-  [k: string]: FindOptionsWhereField | BindPattern[] | FindOptionsWhere[] | undefined;
+  bypassCache?: boolean;
+  [k: string]: FindOptionsWhereField | BindPattern[] | FindOptionsWhere[] | boolean | undefined;
 }
 
 // Add these new types
@@ -106,4 +108,5 @@ export interface FindCountOptions {
   relations?: FindOptionsRelations;
   order?: FindOptionsOrder;
   offset?: number;
+  bypassCache?: boolean;
 }