@ductape/sdk 0.1.110 → 0.1.113

package/dist/functions/functions.runtime.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.portableFunctions = exports.PortableFunctionsRegistry = exports.PortableFunctionError = void 0;
+exports.referenceFromContract = referenceFromContract;
+exports.signInvocation = signInvocation;
+exports.verifyInvocationSignature = verifyInvocationSignature;
+exports.validatePortableValue = validatePortableValue;
+const crypto_1 = require("crypto");
+const contracts = new Map();
+const keyFor = (namespace, version) => `${namespace}@${version}`;
+class PortableFunctionError extends Error {
+    constructor(code, message, retryable = false, details) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.details = details;
+        this.name = 'PortableFunctionError';
+    }
+}
+exports.PortableFunctionError = PortableFunctionError;
+class PortableFunctionsRegistry {
+    registerEventsInvoker(invoker) {
+        this.eventsInvoker = invoker;
+    }
+    register(contract) {
+        assertIdentifier(contract.namespace, 'namespace');
+        assertIdentifier(contract.version, 'version');
+        if (!contract.operations || Object.keys(contract.operations).length === 0) {
+            throw new PortableFunctionError('FUNCTION_CONTRACT_INVALID', `Function contract ${contract.namespace}@${contract.version} has no operations.`);
+        }
+        for (const [operation, definition] of Object.entries(contract.operations)) {
+            assertIdentifier(operation, 'operation');
+            if (!definition.input || !definition.output) {
+                throw new PortableFunctionError('FUNCTION_CONTRACT_INVALID', `${contract.namespace}.${operation}@${contract.version} requires input and output schemas.`);
+            }
+        }
+        contracts.set(keyFor(contract.namespace, contract.version), contract);
+        return this.use(contract);
+    }
+    use(contract) {
+        return new Proxy({}, {
+            get: (_target, property) => {
+                if (typeof property !== 'string' || !(property in contract.operations))
+                    return undefined;
+                return async (input) => this.invoke(referenceFromContract(contract, property), input, {
+                    product: 'local', env: 'local', feature_id: (0, crypto_1.randomUUID)(), feature_tag: 'direct-function-invocation',
+                    step_tag: property, invocation_id: (0, crypto_1.randomUUID)(),
+                }, '');
+            },
+        });
+    }
+    get(namespace, version) {
+        return contracts.get(keyFor(namespace, version));
+    }
+    list() {
+        return [...contracts.values()].map(contract => ({
+            namespace: contract.namespace, version: contract.version, operations: Object.keys(contract.operations),
+        }));
+    }
+    async invoke(reference, input, context, accessKey) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        validatePortableValue(reference.input_schema, input, 'input');
+        const local = (_a = this.get(reference.namespace, reference.version)) === null || _a === void 0 ? void 0 : _a.operations[reference.operation];
+        let output;
+        if (local === null || local === void 0 ? void 0 : local.handler) {
+            output = await withDeadline(Promise.resolve(local.handler(input, context)), reference.timeout_ms, reference);
+        }
+        else {
+            const http = reference.transports.find(transport => transport.type === 'http');
+            const events = reference.transports.find(transport => transport.type === 'events');
+            if ((!http || http.type !== 'http') && (events === null || events === void 0 ? void 0 : events.type) === 'events' && this.eventsInvoker) {
+                const response = await withDeadline(this.eventsInvoker(events, {
+                    function: { namespace: reference.namespace, operation: reference.operation, version: reference.version },
+                    input: input, context,
+                }), (_b = events.timeout_ms) !== null && _b !== void 0 ? _b : reference.timeout_ms, reference);
+                if (response.invocation_id !== context.invocation_id)
+                    throw new PortableFunctionError('FUNCTION_CORRELATION_MISMATCH', 'Function Event response invocation_id does not match the request.');
+                if (response.error)
+                    throw new PortableFunctionError(response.error.code, response.error.message, response.error.retryable, response.error.details);
+                output = response.output;
+            }
+            else if (!http || http.type !== 'http') {
+                throw new PortableFunctionError('FUNCTION_UNAVAILABLE', `No local handler, configured Events invoker, or HTTP transport is available for ${reference.namespace}.${reference.operation}@${reference.version}.`, true);
+            }
+            else {
+                if (!accessKey)
+                    throw new PortableFunctionError('FUNCTION_AUTH_UNAVAILABLE', 'An access key is required for signed HTTP function invocation.');
+                const invocation = {
+                    function: { namespace: reference.namespace, operation: reference.operation, version: reference.version },
+                    input: input, context,
+                };
+                const body = JSON.stringify(invocation);
+                const timestamp = Date.now().toString();
+                const signature = signInvocation(accessKey, timestamp, body);
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), (_d = (_c = http.timeout_ms) !== null && _c !== void 0 ? _c : reference.timeout_ms) !== null && _d !== void 0 ? _d : 15000);
+                try {
+                    const response = await fetch(http.url, {
+                        method: 'POST', body, signal: controller.signal,
+                        headers: {
+                            'content-type': 'application/json',
+                            'x-ductape-invocation-id': context.invocation_id,
+                            'x-ductape-timestamp': timestamp,
+                            'x-ductape-signature': signature,
+                            'x-ductape-function': `${reference.namespace}.${reference.operation}@${reference.version}`,
+                        },
+                    });
+                    const responseBody = await response.json();
+                    if (!response.ok || responseBody.error) {
+                        throw new PortableFunctionError((_f = (_e = responseBody.error) === null || _e === void 0 ? void 0 : _e.code) !== null && _f !== void 0 ? _f : 'FUNCTION_HTTP_ERROR', (_h = (_g = responseBody.error) === null || _g === void 0 ? void 0 : _g.message) !== null && _h !== void 0 ? _h : `Function endpoint returned HTTP ${response.status}.`, (_k = (_j = responseBody.error) === null || _j === void 0 ? void 0 : _j.retryable) !== null && _k !== void 0 ? _k : response.status >= 500, (_l = responseBody.error) === null || _l === void 0 ? void 0 : _l.details);
+                    }
+                    if (responseBody.invocation_id !== context.invocation_id) {
+                        throw new PortableFunctionError('FUNCTION_CORRELATION_MISMATCH', 'Function response invocation_id does not match the request.');
+                    }
+                    output = responseBody.output;
+                }
+                finally {
+                    clearTimeout(timeout);
+                }
+            }
+        }
+        validatePortableValue(reference.output_schema, output, 'output');
+        return output;
+    }
+}
+exports.PortableFunctionsRegistry = PortableFunctionsRegistry;
+exports.portableFunctions = new PortableFunctionsRegistry();
+function referenceFromContract(contract, operation) {
+    var _a, _b, _c;
+    const definition = contract.operations[operation];
+    if (!definition)
+        throw new PortableFunctionError('FUNCTION_OPERATION_NOT_FOUND', `${contract.namespace}.${operation}@${contract.version} is not declared.`);
+    const declared = (_a = definition.transports) !== null && _a !== void 0 ? _a : [{ type: 'local' }];
+    const baseUrl = typeof process !== 'undefined' ? (_c = (_b = process.env) === null || _b === void 0 ? void 0 : _b.DUCTAPE_FUNCTION_BASE_URL) === null || _c === void 0 ? void 0 : _c.replace(/\/$/, '') : undefined;
+    const transports = [...declared];
+    if (baseUrl && !transports.some(transport => transport.type === 'http')) {
+        assertSecureFunctionUrl(baseUrl);
+        transports.push({
+            type: 'http',
+            url: `${baseUrl}/.well-known/ductape/functions/${encodeURIComponent(contract.namespace)}/${encodeURIComponent(contract.version)}/${encodeURIComponent(operation)}`,
+            timeout_ms: definition.timeout_ms,
+            authentication: 'ductape_hmac_sha256',
+        });
+    }
+    return {
+        namespace: contract.namespace, operation, version: contract.version,
+        input_schema: definition.input, output_schema: definition.output,
+        transports,
+        timeout_ms: definition.timeout_ms, idempotent: definition.idempotent,
+    };
+}
+function assertSecureFunctionUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch (_a) {
+        throw new PortableFunctionError('FUNCTION_CONTRACT_INVALID', `DUCTAPE_FUNCTION_BASE_URL is not a valid URL: ${JSON.stringify(url)}.`);
+    }
+    const local = parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1' || parsed.hostname === '::1';
+    if (parsed.protocol !== 'https:' && !(local && parsed.protocol === 'http:')) {
+        throw new PortableFunctionError('FUNCTION_INSECURE_TRANSPORT', 'Portable function HTTP endpoints must use HTTPS. HTTP is allowed only for localhost development.');
+    }
+}
+function signInvocation(accessKey, timestamp, body) {
+    return (0, crypto_1.createHmac)('sha256', accessKey).update(`${timestamp}.${body}`).digest('hex');
+}
+function verifyInvocationSignature(accessKey, timestamp, body, signature, toleranceMs = 300000) {
+    const parsed = Number(timestamp);
+    if (!Number.isFinite(parsed) || Math.abs(Date.now() - parsed) > toleranceMs)
+        return false;
+    const expected = Buffer.from(signInvocation(accessKey, timestamp, body), 'hex');
+    const supplied = Buffer.from(signature, 'hex');
+    return expected.length === supplied.length && (0, crypto_1.timingSafeEqual)(expected, supplied);
+}
+function validatePortableValue(schema, value, path) {
+    var _a, _b, _c;
+    const fail = (message) => { throw new PortableFunctionError('FUNCTION_SCHEMA_VALIDATION_FAILED', `${path} ${message}`); };
+    if (schema.enum && !schema.enum.some(candidate => Object.is(candidate, value)))
+        fail(`must be one of ${JSON.stringify(schema.enum)}.`);
+    if (!schema.type)
+        return;
+    if (schema.type === 'null') {
+        if (value !== null)
+            fail('must be null.');
+        return;
+    }
+    if (schema.type === 'array') {
+        if (!Array.isArray(value))
+            fail('must be an array.');
+        const arrayValue = value;
+        if (schema.items)
+            arrayValue.forEach((item, index) => validatePortableValue(schema.items, item, `${path}[${index}]`));
+        return;
+    }
+    if (schema.type === 'object') {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            fail('must be an object.');
+        const record = value;
+        for (const required of (_a = schema.required) !== null && _a !== void 0 ? _a : [])
+            if (!(required in record))
+                fail(`is missing required property "${required}".`);
+        for (const [key, nested] of Object.entries((_b = schema.properties) !== null && _b !== void 0 ? _b : {}))
+            if (key in record)
+                validatePortableValue(nested, record[key], `${path}.${key}`);
+        if (schema.additionalProperties === false) {
+            const known = new Set(Object.keys((_c = schema.properties) !== null && _c !== void 0 ? _c : {}));
+            for (const key of Object.keys(record))
+                if (!known.has(key))
+                    fail(`contains unknown property "${key}".`);
+        }
+        return;
+    }
+    const actual = typeof value;
+    if (schema.type === 'integer') {
+        if (actual !== 'number' || !Number.isInteger(value))
+            fail('must be an integer.');
+    }
+    else if (actual !== schema.type)
+        fail(`must be a ${schema.type}.`);
+    if (typeof value === 'string') {
+        if (schema.minLength != null && value.length < schema.minLength)
+            fail(`must contain at least ${schema.minLength} characters.`);
+        if (schema.maxLength != null && value.length > schema.maxLength)
+            fail(`must contain at most ${schema.maxLength} characters.`);
+    }
+    if (typeof value === 'number') {
+        if (schema.minimum != null && value < schema.minimum)
+            fail(`must be >= ${schema.minimum}.`);
+        if (schema.maximum != null && value > schema.maximum)
+            fail(`must be <= ${schema.maximum}.`);
+    }
+}
+function assertIdentifier(value, label) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(value)) {
+        throw new PortableFunctionError('FUNCTION_CONTRACT_INVALID', `Invalid function ${label}: ${JSON.stringify(value)}.`);
+    }
+}
+async function withDeadline(promise, timeoutMs, reference) {
+    if (!timeoutMs)
+        return promise;
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => { timer = setTimeout(() => reject(new PortableFunctionError('FUNCTION_TIMEOUT', `${reference.namespace}.${reference.operation}@${reference.version} exceeded ${timeoutMs}ms.`, true)), timeoutMs); }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=functions.runtime.js.map

package/dist/functions/functions.runtime.js.map

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

package/dist/functions/http-handler.d.ts

@@ -0,0 +1,17 @@
+import type { IPortableFunctionInvocationResponse } from './types';
+export interface IPortableFunctionHttpRequest {
+    headers: Record<string, string | string[] | undefined>;
+    body: string | Buffer | Record<string, unknown>;
+    params?: {
+        namespace?: string;
+        version?: string;
+        operation?: string;
+    };
+}
+export interface IPortableFunctionHttpResult {
+    status: number;
+    body: IPortableFunctionInvocationResponse;
+}
+export declare const PORTABLE_FUNCTION_HTTP_PATH = "/.well-known/ductape/functions/:namespace/:version/:operation";
+/** Framework-neutral signed HTTP handler. Nest/Express adapters can pass raw request headers/body here. */
+export declare function handlePortableFunctionHttpRequest(request: IPortableFunctionHttpRequest, accessKey: string): Promise<IPortableFunctionHttpResult>;

package/dist/functions/http-handler.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PORTABLE_FUNCTION_HTTP_PATH = void 0;
+exports.handlePortableFunctionHttpRequest = handlePortableFunctionHttpRequest;
+const functions_runtime_1 = require("./functions.runtime");
+exports.PORTABLE_FUNCTION_HTTP_PATH = '/.well-known/ductape/functions/:namespace/:version/:operation';
+/** Framework-neutral signed HTTP handler. Nest/Express adapters can pass raw request headers/body here. */
+async function handlePortableFunctionHttpRequest(request, accessKey) {
+    var _a, _b, _c;
+    const rawBody = typeof request.body === 'string' || Buffer.isBuffer(request.body)
+        ? request.body.toString()
+        : JSON.stringify(request.body);
+    const timestamp = firstHeader(request.headers['x-ductape-timestamp']);
+    const signature = firstHeader(request.headers['x-ductape-signature']);
+    if (!timestamp || !signature || !(0, functions_runtime_1.verifyInvocationSignature)(accessKey, timestamp, rawBody, signature)) {
+        return { status: 401, body: { invocation_id: (_a = firstHeader(request.headers['x-ductape-invocation-id'])) !== null && _a !== void 0 ? _a : '', error: { code: 'FUNCTION_SIGNATURE_INVALID', message: 'Function invocation signature is invalid or expired.' } } };
+    }
+    let invocation;
+    try {
+        invocation = JSON.parse(rawBody);
+    }
+    catch (_d) {
+        return { status: 400, body: { invocation_id: '', error: { code: 'FUNCTION_REQUEST_INVALID', message: 'Function request body is not valid JSON.' } } };
+    }
+    try {
+        const route = request.params;
+        if (route && (route.namespace !== invocation.function.namespace || route.version !== invocation.function.version || route.operation !== invocation.function.operation)) {
+            throw new functions_runtime_1.PortableFunctionError('FUNCTION_ROUTE_MISMATCH', 'Function route parameters do not match the signed invocation body.');
+        }
+        const declaredHeader = firstHeader(request.headers['x-ductape-function']);
+        const expectedHeader = `${invocation.function.namespace}.${invocation.function.operation}@${invocation.function.version}`;
+        if (declaredHeader !== expectedHeader)
+            throw new functions_runtime_1.PortableFunctionError('FUNCTION_ROUTE_MISMATCH', 'X-Ductape-Function does not match the signed invocation body.');
+        const contract = functions_runtime_1.portableFunctions.get(invocation.function.namespace, invocation.function.version);
+        const operation = contract === null || contract === void 0 ? void 0 : contract.operations[invocation.function.operation];
+        if (!contract || !(operation === null || operation === void 0 ? void 0 : operation.handler))
+            throw new functions_runtime_1.PortableFunctionError('FUNCTION_UNAVAILABLE', `No local handler is registered for ${invocation.function.namespace}.${invocation.function.operation}@${invocation.function.version}.`, true);
+        const output = await functions_runtime_1.portableFunctions.invoke({
+            namespace: contract.namespace, operation: invocation.function.operation, version: contract.version,
+            input_schema: operation.input, output_schema: operation.output, transports: [{ type: 'local' }],
+            timeout_ms: operation.timeout_ms, idempotent: operation.idempotent,
+        }, invocation.input, invocation.context, accessKey);
+        return { status: 200, body: { invocation_id: invocation.context.invocation_id, output } };
+    }
+    catch (error) {
+        const normalized = error instanceof functions_runtime_1.PortableFunctionError ? error : new functions_runtime_1.PortableFunctionError('FUNCTION_EXECUTION_FAILED', error instanceof Error ? error.message : String(error));
+        return { status: normalized.code === 'FUNCTION_UNAVAILABLE' ? 503 : 422, body: { invocation_id: (_c = (_b = invocation.context) === null || _b === void 0 ? void 0 : _b.invocation_id) !== null && _c !== void 0 ? _c : '', error: { code: normalized.code, message: normalized.message, retryable: normalized.retryable, details: normalized.details } } };
+    }
+}
+const firstHeader = (value) => Array.isArray(value) ? value[0] : value;
+//# sourceMappingURL=http-handler.js.map

package/dist/functions/http-handler.js.map

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

package/dist/functions/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './functions.runtime';
+export * from './http-handler';

package/dist/functions/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./functions.runtime"), exports);
+__exportStar(require("./http-handler"), exports);
+//# sourceMappingURL=index.js.map

package/dist/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,sDAAoC;AACpC,iDAA+B"}

package/dist/functions/types.d.ts

@@ -0,0 +1,94 @@
+export type PortableJsonSchema = {
+    type?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    properties?: Record<string, PortableJsonSchema>;
+    required?: string[];
+    items?: PortableJsonSchema;
+    enum?: unknown[];
+    additionalProperties?: boolean | PortableJsonSchema;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+};
+export interface IPortableFunctionContext {
+    product: string;
+    env: string;
+    workspace_id?: string;
+    feature_id: string;
+    feature_tag: string;
+    step_tag: string;
+    invocation_id: string;
+    trace_id?: string;
+    /** Inherited feature session. Kept outside business input. */
+    session?: string;
+    deadline_at?: number;
+    idempotency_key?: string;
+}
+export interface IPortableFunctionHttpTransport {
+    type: 'http';
+    url: string;
+    timeout_ms?: number;
+    /** HMAC-SHA256 using the SDK access key. Unsigned HTTP invocation is intentionally unsupported. */
+    authentication: 'ductape_hmac_sha256';
+}
+export interface IPortableFunctionLocalTransport {
+    type: 'local';
+}
+export interface IPortableFunctionEventsTransport {
+    type: 'events';
+    /** Full broker/topic event names. */
+    request_event: string;
+    response_event: string;
+    timeout_ms?: number;
+}
+export type PortableFunctionTransport = IPortableFunctionLocalTransport | IPortableFunctionHttpTransport | IPortableFunctionEventsTransport;
+export type PortableFunctionEventsInvoker = (transport: IPortableFunctionEventsTransport, invocation: IPortableFunctionInvocation) => Promise<IPortableFunctionInvocationResponse>;
+export interface IPortableFunctionOperationContract<TInput = Record<string, unknown>, TOutput = unknown> {
+    input: PortableJsonSchema;
+    output: PortableJsonSchema;
+    description?: string;
+    timeout_ms?: number;
+    idempotent?: boolean;
+    transports?: PortableFunctionTransport[];
+    handler?: (input: TInput, context: IPortableFunctionContext) => Promise<TOutput> | TOutput;
+}
+export interface IPortableFunctionContract<TOperations extends Record<string, IPortableFunctionOperationContract<any, any>> = Record<string, IPortableFunctionOperationContract<any, any>>> {
+    namespace: string;
+    version: string;
+    description?: string;
+    operations: TOperations;
+}
+export interface IPortableFunctionReference {
+    namespace: string;
+    operation: string;
+    version: string;
+    input_schema: PortableJsonSchema;
+    output_schema: PortableJsonSchema;
+    transports: PortableFunctionTransport[];
+    timeout_ms?: number;
+    idempotent?: boolean;
+}
+export interface IPortableFunctionInvocation<TInput = Record<string, unknown>> {
+    function: Pick<IPortableFunctionReference, 'namespace' | 'operation' | 'version'>;
+    input: TInput;
+    context: IPortableFunctionContext;
+}
+export interface IPortableFunctionInvocationResponse<TOutput = unknown> {
+    invocation_id: string;
+    output?: TOutput;
+    error?: {
+        code: string;
+        message: string;
+        retryable?: boolean;
+        details?: unknown;
+    };
+}
+export type PortableFunctionClient<TContract extends IPortableFunctionContract> = {
+    [K in keyof TContract['operations']]: TContract['operations'][K] extends IPortableFunctionOperationContract<infer TInput, infer TOutput> ? (input: TInput) => Promise<TOutput> : never;
+};
+export declare function defineFunctions<T extends IPortableFunctionContract>(contract: T): T;
+/**
+ * Preserves an operation's application input/output types even when the portable
+ * contract intentionally contains no local handler.
+ */
+export declare function defineFunction<TInput, TOutput>(operation: IPortableFunctionOperationContract<TInput, TOutput>): IPortableFunctionOperationContract<TInput, TOutput>;

package/dist/functions/types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineFunctions = defineFunctions;
+exports.defineFunction = defineFunction;
+function defineFunctions(contract) {
+    return contract;
+}
+/**
+ * Preserves an operation's application input/output types even when the portable
+ * contract intentionally contains no local handler.
+ */
+function defineFunction(operation) {
+    return operation;
+}
+//# sourceMappingURL=types.js.map

package/dist/functions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/functions/types.ts"],"names":[],"mappings":";;AAqGA,0CAEC;AAMD,wCAIC;AAZD,SAAgB,eAAe,CAAsC,QAAW;IAC9E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC5B,SAA8D;IAE9D,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/graph/graphs.service.d.ts

@@ -377,7 +377,7 @@ export declare class GraphService {
      * );
      * ```
      */
-    query<T = any>(queryString: string, params?: Record<string, any>, transaction?: IGraphTransaction): Promise<IRawQueryResult<T>>;
+    query<T = any>(queryString: string, params?: Record<string, any>, transaction?: IGraphTransaction, session?: string): Promise<IRawQueryResult<T>>;
     /**
      * Create a node index
      * As documented in overview.md