@comake/skl-js-engine 1.5.4 → 1.5.5

package/dist/util/PerformanceLogger.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerformanceLogger = void 0;
+/* eslint-disable require-unicode-regexp */
+/* eslint-disable @typescript-eslint/naming-convention */
+const perf_hooks_1 = require("perf_hooks");
+let AsyncLocalStorage;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, prefer-destructuring, global-require, @typescript-eslint/no-var-requires
+    AsyncLocalStorage = require('async_hooks').AsyncLocalStorage;
+}
+catch {
+    // AsyncLocalStorage not available
+}
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+class PerformanceLogger {
+    static initialize() {
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        // eslint-disable-next-line no-process-env
+        this.enabled = process.env.SKL_ENGINE_DEBUG_QUERIES === 'true' ||
+            // eslint-disable-next-line no-process-env
+            process.env.SKL_ENGINE_DEBUG_QUERIES === '1';
+        if (this.enabled && AsyncLocalStorage) {
+            this.asyncLocalStorage = new AsyncLocalStorage();
+        }
+    }
+    static generateSpanId() {
+        // eslint-disable-next-line no-plusplus
+        return `span-${++this.spanCounter}-${Date.now()}`;
+    }
+    static startSpan(name, attributes) {
+        this.initialize();
+        if (!this.enabled) {
+            return null;
+        }
+        const parent = this.asyncLocalStorage?.getStore();
+        const span = {
+            id: this.generateSpanId(),
+            parentId: parent?.id,
+            name,
+            startTime: perf_hooks_1.performance.now(),
+            attributes: attributes ?? {},
+            children: []
+        };
+        if (parent) {
+            parent.children.push(span);
+        }
+        return span;
+    }
+    static endSpan(span, additionalAttributes) {
+        if (!this.enabled || !span) {
+            return;
+        }
+        span.endTime = perf_hooks_1.performance.now();
+        span.duration = span.endTime - span.startTime;
+        if (additionalAttributes) {
+            span.attributes = { ...span.attributes, ...additionalAttributes };
+        }
+    }
+    static async withSpan(name, fn, attributes) {
+        this.initialize();
+        if (!this.enabled) {
+            return fn();
+        }
+        const span = this.startSpan(name, attributes);
+        if (this.asyncLocalStorage) {
+            return this.asyncLocalStorage.run(span, async () => {
+                try {
+                    const result = await fn();
+                    this.endSpan(span);
+                    return result;
+                }
+                catch (error) {
+                    this.endSpan(span, { error: true, errorMessage: error instanceof Error ? error.message : String(error) });
+                    throw error;
+                }
+            });
+        }
+        // Fallback without AsyncLocalStorage
+        try {
+            const result = await fn();
+            this.endSpan(span);
+            return result;
+        }
+        catch (error) {
+            this.endSpan(span, { error: true, errorMessage: error instanceof Error ? error.message : String(error) });
+            throw error;
+        }
+    }
+    static async withSpanRoot(name, fn, attributes) {
+        this.initialize();
+        if (!this.enabled) {
+            return fn();
+        }
+        const span = this.startSpan(name, attributes);
+        if (this.asyncLocalStorage) {
+            return this.asyncLocalStorage.run(span, async () => {
+                try {
+                    const result = await fn();
+                    this.endSpan(span);
+                    this.logSpanTree(span);
+                    return result;
+                }
+                catch (error) {
+                    this.endSpan(span, { error: true, errorMessage: error instanceof Error ? error.message : String(error) });
+                    this.logSpanTree(span);
+                    throw error;
+                }
+            });
+        }
+        // Fallback without AsyncLocalStorage
+        try {
+            const result = await fn();
+            this.endSpan(span);
+            this.logSpanTree(span);
+            return result;
+        }
+        catch (error) {
+            this.endSpan(span, { error: true, errorMessage: error instanceof Error ? error.message : String(error) });
+            this.logSpanTree(span);
+            throw error;
+        }
+    }
+    static getCurrentSpan() {
+        this.initialize();
+        if (!this.enabled || !this.asyncLocalStorage) {
+            return undefined;
+        }
+        return this.asyncLocalStorage.getStore();
+    }
+    static logSpanTree(rootSpan) {
+        if (!this.enabled || !rootSpan) {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const lines = [];
+        lines.push('');
+        lines.push('╔══════════════════════════════════════════════════════════════╗');
+        lines.push(`║ SKL Engine Performance Trace                                 ║`);
+        lines.push(`║ Started: ${timestamp}                            ║`);
+        lines.push('╚══════════════════════════════════════════════════════════════╝');
+        lines.push('');
+        this.buildSpanTreeLines(rootSpan, lines, '', true);
+        lines.push('');
+        lines.push('═══════════════════════════════════════════════════════════════');
+        lines.push('');
+        // eslint-disable-next-line no-console
+        console.log(lines.join('\n'));
+    }
+    static buildSpanTreeLines(span, lines, prefix, isRoot) {
+        const duration = span.duration !== undefined ? `${span.duration.toFixed(2)}ms` : 'running...';
+        const status = span.attributes.error ? '✗' : '✓';
+        lines.push(`${prefix}${span.name} [${duration}] ${status}`);
+        // Show important attributes
+        this.addAttributeLines(span, lines, prefix);
+        // Process children
+        const childCount = span.children.length;
+        span.children.forEach((child, index) => {
+            const isLast = index === childCount - 1;
+            const childPrefix = prefix + (isRoot ? '' : '│  ');
+            const connector = isLast ? '└─ ' : '├─ ';
+            const nextPrefix = prefix + (isRoot ? '' : (isLast ? '   ' : '│  '));
+            this.buildSpanTreeLines(child, lines, childPrefix + connector, false);
+        });
+    }
+    static addAttributeLines(span, lines, prefix) {
+        const { query, resultCount, options, error, errorMessage, ...otherAttrs } = span.attributes;
+        // Show query if present (and format it) - but make it easy to copy
+        if (query && typeof query === 'string') {
+            lines.push(`${prefix}│  Query:`);
+            // Empty line before query
+            lines.push('');
+            const formattedQuery = this.formatQuery(query);
+            formattedQuery.split('\n').forEach(line => {
+                // Simple indentation without tree chars
+                lines.push(`    ${line}`);
+            });
+            // Empty line after query
+            lines.push('');
+        }
+        // Show result count
+        if (resultCount !== undefined) {
+            lines.push(`${prefix}│  Result: ${resultCount} ${resultCount === 1 ? 'row' : 'rows'}`);
+        }
+        // Show error if present
+        if (error && errorMessage) {
+            lines.push(`${prefix}│  Error: ${errorMessage}`);
+        }
+        // Show other important attributes
+        if (Object.keys(otherAttrs).length > 0) {
+            const attrStr = JSON.stringify(otherAttrs);
+            if (attrStr.length < 100) {
+                lines.push(`${prefix}│  Attributes: ${attrStr}`);
+            }
+        }
+    }
+    static formatQuery(query) {
+        // Simple query formatting with proper indentation
+        let formatted = query.trim();
+        // Add line breaks after key SPARQL keywords for readability
+        formatted = formatted
+            .replace(/\s+/g, ' ')
+            .replace(/\s*{\s*/g, ' {\n  ')
+            .replace(/\s*}\s*/g, '\n}')
+            .replace(/\s*\.\s*(?=[?A-Z])/g, ' .\n  ')
+            .replace(/\bWHERE\b/g, '\nWHERE')
+            .replace(/\bFILTER\b/g, '\n  FILTER')
+            .replace(/\bOPTIONAL\b/g, '\n  OPTIONAL')
+            .replace(/\bUNION\b/g, '\nUNION')
+            .replace(/\bGRAPH\b/g, '\n  GRAPH')
+            .replace(/\bORDER BY\b/g, '\nORDER BY')
+            .replace(/\bLIMIT\b/g, '\nLIMIT')
+            .replace(/\bOFFSET\b/g, '\nOFFSET');
+        return formatted;
+    }
+}
+exports.PerformanceLogger = PerformanceLogger;
+PerformanceLogger.initialized = false;
+PerformanceLogger.spanCounter = 0;
+//# sourceMappingURL=PerformanceLogger.js.map

package/dist/util/PerformanceLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceLogger.js","sourceRoot":"","sources":["../../src/util/PerformanceLogger.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable require-unicode-regexp */\n/* eslint-disable @typescript-eslint/naming-convention */\nimport { performance } from 'perf_hooks';\n\nexport interface Span {\n  id: string;\n  parentId?: string;\n  name: string;\n  startTime: number;\n  endTime?: number;\n  duration?: number;\n  attributes: Record<string, any>;\n  children: Span[];\n}\n\nlet AsyncLocalStorage: any;\ntry {\n  // eslint-disable-next-line @typescript-eslint/no-require-imports, prefer-destructuring, global-require, @typescript-eslint/no-var-requires\n  AsyncLocalStorage = require('async_hooks').AsyncLocalStorage;\n} catch {\n  // AsyncLocalStorage not available\n}\n\n// eslint-disable-next-line @typescript-eslint/no-extraneous-class\nexport class PerformanceLogger {\n  private static asyncLocalStorage?: any;\n  private static enabled: boolean;\n  private static initialized = false;\n  private static spanCounter = 0;\n\n  private static initialize(): void {\n    if (this.initialized) {\n      return;\n    }\n    this.initialized = true;\n    // eslint-disable-next-line no-process-env\n    this.enabled = process.env.SKL_ENGINE_DEBUG_QUERIES === 'true' || \n                   // eslint-disable-next-line no-process-env\n                   process.env.SKL_ENGINE_DEBUG_QUERIES === '1';\n    \n    if (this.enabled && AsyncLocalStorage) {\n      this.asyncLocalStorage = new AsyncLocalStorage();\n    }\n  }\n\n  private static generateSpanId(): string {\n    // eslint-disable-next-line no-plusplus\n    return `span-${++this.spanCounter}-${Date.now()}`;\n  }\n\n  public static startSpan(name: string, attributes?: Record<string, any>): Span {\n    this.initialize();\n    \n    if (!this.enabled) {\n      return null as any;\n    }\n\n    const parent = this.asyncLocalStorage?.getStore();\n    \n    const span: Span = {\n      id: this.generateSpanId(),\n      parentId: parent?.id,\n      name,\n      startTime: performance.now(),\n      attributes: attributes ?? {},\n      children: []\n    };\n\n    if (parent) {\n      parent.children.push(span);\n    }\n\n    return span;\n  }\n\n  public static endSpan(span: Span, additionalAttributes?: Record<string, any>): void {\n    if (!this.enabled || !span) {\n      return;\n    }\n\n    span.endTime = performance.now();\n    span.duration = span.endTime - span.startTime;\n\n    if (additionalAttributes) {\n      span.attributes = { ...span.attributes, ...additionalAttributes };\n    }\n  }\n\n  public static async withSpan<T>(\n    name: string,\n    fn: () => Promise<T> | T,\n    attributes?: Record<string, any>\n  ): Promise<T> {\n    this.initialize();\n    \n    if (!this.enabled) {\n      return fn() as any;\n    }\n\n    const span = this.startSpan(name, attributes);\n\n    if (this.asyncLocalStorage) {\n      return this.asyncLocalStorage.run(span, async() => {\n        try {\n          const result = await fn();\n          this.endSpan(span);\n          return result;\n        } catch (error) {\n          this.endSpan(span, { error: true, errorMessage: error instanceof Error ? error.message : String(error) });\n          throw error;\n        }\n      });\n    }\n\n    // Fallback without AsyncLocalStorage\n    try {\n      const result = await fn();\n      this.endSpan(span);\n      return result;\n    } catch (error) {\n      this.endSpan(span, { error: true, errorMessage: error instanceof Error ? error.message : String(error) });\n      throw error;\n    }\n  }\n\n  public static async withSpanRoot<T>(\n    name: string,\n    fn: () => Promise<T> | T,\n    attributes?: Record<string, any>\n  ): Promise<T> {\n    this.initialize();\n    \n    if (!this.enabled) {\n      return fn() as any;\n    }\n\n    const span = this.startSpan(name, attributes);\n\n    if (this.asyncLocalStorage) {\n      return this.asyncLocalStorage.run(span, async() => {\n        try {\n          const result = await fn();\n          this.endSpan(span);\n          this.logSpanTree(span);\n          return result;\n        } catch (error) {\n          this.endSpan(span, { error: true, errorMessage: error instanceof Error ? error.message : String(error) });\n          this.logSpanTree(span);\n          throw error;\n        }\n      });\n    }\n\n    // Fallback without AsyncLocalStorage\n    try {\n      const result = await fn();\n      this.endSpan(span);\n      this.logSpanTree(span);\n      return result;\n    } catch (error) {\n      this.endSpan(span, { error: true, errorMessage: error instanceof Error ? error.message : String(error) });\n      this.logSpanTree(span);\n      throw error;\n    }\n  }\n\n  public static getCurrentSpan(): Span | undefined {\n    this.initialize();\n    \n    if (!this.enabled || !this.asyncLocalStorage) {\n      return undefined;\n    }\n\n    return this.asyncLocalStorage.getStore();\n  }\n\n  public static logSpanTree(rootSpan: Span): void {\n    if (!this.enabled || !rootSpan) {\n      return;\n    }\n\n    const timestamp = new Date().toISOString();\n    const lines: string[] = [];\n\n    lines.push('');\n    lines.push('╔══════════════════════════════════════════════════════════════╗');\n    lines.push(`║ SKL Engine Performance Trace                                 ║`);\n    lines.push(`║ Started: ${timestamp}                            ║`);\n    lines.push('╚══════════════════════════════════════════════════════════════╝');\n    lines.push('');\n\n    this.buildSpanTreeLines(rootSpan, lines, '', true);\n\n    lines.push('');\n    lines.push('═══════════════════════════════════════════════════════════════');\n    lines.push('');\n\n    // eslint-disable-next-line no-console\n    console.log(lines.join('\\n'));\n  }\n\n  private static buildSpanTreeLines(\n    span: Span,\n    lines: string[],\n    prefix: string,\n    isRoot: boolean\n  ): void {\n    const duration = span.duration !== undefined ? `${span.duration.toFixed(2)}ms` : 'running...';\n    const status = span.attributes.error ? '✗' : '✓';\n    \n    lines.push(`${prefix}${span.name} [${duration}] ${status}`);\n\n    // Show important attributes\n    this.addAttributeLines(span, lines, prefix);\n\n    // Process children\n    const childCount = span.children.length;\n    span.children.forEach((child, index) => {\n      const isLast = index === childCount - 1;\n      const childPrefix = prefix + (isRoot ? '' : '│  ');\n      const connector = isLast ? '└─ ' : '├─ ';\n      const nextPrefix = prefix + (isRoot ? '' : (isLast ? '   ' : '│  '));\n      \n      this.buildSpanTreeLines(child, lines, childPrefix + connector, false);\n    });\n  }\n\n  private static addAttributeLines(span: Span, lines: string[], prefix: string): void {\n    const { query, resultCount, options, error, errorMessage, ...otherAttrs } = span.attributes;\n\n    // Show query if present (and format it) - but make it easy to copy\n    if (query && typeof query === 'string') {\n      lines.push(`${prefix}│  Query:`);\n      // Empty line before query\n      lines.push(''); \n      const formattedQuery = this.formatQuery(query);\n      formattedQuery.split('\\n').forEach(line => {\n        // Simple indentation without tree chars\n        lines.push(`    ${line}`); \n      });\n      // Empty line after query\n      lines.push(''); \n    }\n\n    // Show result count\n    if (resultCount !== undefined) {\n      lines.push(`${prefix}│  Result: ${resultCount} ${resultCount === 1 ? 'row' : 'rows'}`);\n    }\n\n    // Show error if present\n    if (error && errorMessage) {\n      lines.push(`${prefix}│  Error: ${errorMessage}`);\n    }\n\n    // Show other important attributes\n    if (Object.keys(otherAttrs).length > 0) {\n      const attrStr = JSON.stringify(otherAttrs);\n      if (attrStr.length < 100) {\n        lines.push(`${prefix}│  Attributes: ${attrStr}`);\n      }\n    }\n  }\n\n  private static formatQuery(query: string): string {\n    // Simple query formatting with proper indentation\n    let formatted = query.trim();\n    \n    // Add line breaks after key SPARQL keywords for readability\n    formatted = formatted\n      .replace(/\\s+/g, ' ')\n      .replace(/\\s*{\\s*/g, ' {\\n  ')\n      .replace(/\\s*}\\s*/g, '\\n}')\n      .replace(/\\s*\\.\\s*(?=[?A-Z])/g, ' .\\n  ')\n      .replace(/\\bWHERE\\b/g, '\\nWHERE')\n      .replace(/\\bFILTER\\b/g, '\\n  FILTER')\n      .replace(/\\bOPTIONAL\\b/g, '\\n  OPTIONAL')\n      .replace(/\\bUNION\\b/g, '\\nUNION')\n      .replace(/\\bGRAPH\\b/g, '\\n  GRAPH')\n      .replace(/\\bORDER BY\\b/g, '\\nORDER BY')\n      .replace(/\\bLIMIT\\b/g, '\\nLIMIT')\n      .replace(/\\bOFFSET\\b/g, '\\nOFFSET');\n\n    return formatted;\n  }\n}\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/dist/util/SparqlUtil.d.ts

@@ -0,0 +1,72 @@
+import type { Literal, NamedNode } from '@rdfjs/types';
+import type { AskQuery, BgpPattern, BindPattern, ClearDropOperation, ConstructQuery, Expression, FilterPattern, GraphPattern, GraphQuads, Grouping, GroupPattern, InsertDeleteOperation, IriTerm, OperationExpression, OptionalPattern, Ordering, Pattern, PropertyPath, SelectQuery, ServicePattern, Triple, UnionPattern, Update, UpdateOperation, ValuesPattern, Variable } from 'sparqljs';
+import type { RawQueryResult } from '../storage/query-adapter/QueryAdapter';
+import type { SelectVariableQueryResult } from '../storage/query-adapter/sparql/query-executor/SparqlQueryExecutor';
+export declare const rdfTypeNamedNode: NamedNode<"http://www.w3.org/1999/02/22-rdf-syntax-ns#type">;
+export declare const rdfsSubClassOfNamedNode: NamedNode<"http://www.w3.org/2000/01/rdf-schema#subClassOf">;
+export declare const subjectNode: import("@rdfjs/types").Variable;
+export declare const predicateNode: import("@rdfjs/types").Variable;
+export declare const objectNode: import("@rdfjs/types").Variable;
+export declare const entityVariable: import("@rdfjs/types").Variable;
+export declare const rdfTypeVariable: import("@rdfjs/types").Variable;
+export declare const rdfTypesVariable: import("@rdfjs/types").Variable;
+export declare const countVariable: import("@rdfjs/types").Variable;
+export declare const now: import("@rdfjs/types").Variable;
+export declare const created: NamedNode<"https://skl.ai/dateTimeCreated">;
+export declare const modified: NamedNode<"https://skl.ai/dateTimeModified">;
+export declare const firstPredicate: NamedNode<"http://www.w3.org/1999/02/22-rdf-syntax-ns#first">;
+export declare const restPredicate: NamedNode<"http://www.w3.org/1999/02/22-rdf-syntax-ns#rest">;
+export declare const nilPredicate: NamedNode<"http://www.w3.org/1999/02/22-rdf-syntax-ns#nil">;
+export declare const anyPredicatePropertyPath: PropertyPath;
+export declare const allTypesAndSuperTypesPath: PropertyPath;
+export declare const bindNow: BindPattern;
+export declare const dropAll: ClearDropOperation;
+export declare const entityGraphTriple: {
+    subject: import("@rdfjs/types").Variable;
+    predicate: import("@rdfjs/types").Variable;
+    object: import("@rdfjs/types").Variable;
+};
+export declare function createSparqlGraphQuads(graph: NamedNode, triples: Triple[]): GraphQuads;
+export declare function createSparqlClearUpdate(graph: NamedNode): ClearDropOperation;
+export declare function createSparqlDropUpdate(graph: NamedNode): ClearDropOperation;
+export declare function createSparqlUpdate(updates: UpdateOperation[]): Update;
+export declare function createSparqlGraphPattern(name: Variable | NamedNode, patterns: Pattern[]): GraphPattern;
+export declare function createSparqlConstructQuery(triples: Triple[], where: Pattern[]): ConstructQuery;
+export declare function createSparqlCountSelectQuery(subject: Variable, where: Pattern[], order: Ordering[], offset?: number): SelectQuery;
+export declare function creteSparqlAskQuery(where: Pattern[]): AskQuery;
+export declare function createSparqlSelectGroup(patterns: Pattern[]): GroupPattern;
+export declare function createSparqlOptional(patterns: Pattern[]): OptionalPattern;
+export declare function createSparqlUnion(patterns: Pattern[]): UnionPattern;
+export declare function createSparqlBasicGraphPattern(triples: Triple[]): BgpPattern;
+export declare function createSparqlOptionalGraphSelection(name: Variable | NamedNode, triples: Triple[]): GraphPattern;
+export declare function createSparqlServicePattern(serviceName: string, triples: Triple[]): ServicePattern;
+export declare function ensureVariable(variableLike: string | Variable): Variable;
+export declare function ensureGrouping(variableLike: Variable | string): Grouping;
+export declare function createSparqlSelectQuery(variable: Variable | Variable[], where: Pattern[], order: Ordering[], group?: Variable | Variable[], limit?: number, offset?: number): SelectQuery;
+export declare function createSparqlFilterWithExpression(expression: Expression): FilterPattern;
+export declare function createFilterPatternFromFilters(filters: Expression[]): FilterPattern;
+export declare function createSparqlBindPattern(expression: Expression, variable: Variable): BindPattern;
+export declare function createSparqlEqualOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlLcaseOperation(expression: Expression): OperationExpression;
+export declare function createSparqlContainsOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlGtOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlGteOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlLtOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlLteOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlNotEqualOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlInOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlNotInOperation(leftSide: Expression, rightSide: Expression): OperationExpression;
+export declare function createSparqlNotExistsOperation(args: Expression[]): OperationExpression;
+export declare function createSparqlExistsOperation(args: Expression[]): OperationExpression;
+export declare function createSparqlInversePredicate(predicates: (IriTerm | PropertyPath)[]): PropertyPath;
+export declare function createSparqlOrPredicate(predicates: (IriTerm | PropertyPath)[]): PropertyPath;
+export declare function createSparqlSequencePredicate(predicates: (IriTerm | PropertyPath)[]): PropertyPath;
+export declare function createSparqlZeroOrMorePredicate(predicates: (IriTerm | PropertyPath)[]): PropertyPath;
+export declare function createSparqlOneOrMorePredicate(predicates: (IriTerm | PropertyPath)[]): PropertyPath;
+export declare function createSparqlInsertDeleteOperation(graph: NamedNode, insertionTriples: Triple[], deletionTriples: Triple[]): InsertDeleteOperation;
+export declare function selectQueryResultsAsJSValues<T extends RawQueryResult>(results: SelectVariableQueryResult<T>[]): T[];
+export declare function groupSelectQueryResultsByKey(results: SelectVariableQueryResult<any>[]): Record<string, (NamedNode | Literal)[]>;
+export declare function getEntityVariableValuesFromVariables(variables: Record<string, (Literal | NamedNode)[]>): string[];
+export declare function getRdfTypeVariableValuesFromVariables(variables: Record<string, (Literal | NamedNode)[]>): string[];
+export declare function createValuesPatternsForVariables(valuesByVariable: Record<string, (NamedNode | Literal)[]>): ValuesPattern[];
+//# sourceMappingURL=SparqlUtil.d.ts.map

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

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