@flutchai/flutch-sdk 0.1.0

package/dist/types/graph-types.d.ts

@@ -0,0 +1,82 @@
+export interface IGraphTracer {
+    log(data: any): void;
+    error(data: any): void;
+}
+export interface IUsageRecorder {
+    recordModelExecution(record: any): void;
+}
+import { BaseChannel, CompiledStateGraph, LangGraphRunnableConfig } from "@langchain/langgraph";
+export type MappedChannels<T> = {
+    [K in keyof T]: BaseChannel<T[K], T[K]>;
+};
+declare global {
+    namespace GraphTypes {
+        interface Registry {
+        }
+    }
+}
+export type IGraphTypeRegistry = GraphTypes.Registry;
+export interface IGenericGraphType {
+    Params: any;
+    State: any;
+    Config: any;
+    Input: any;
+    Definition: any;
+    ConfigDefinition: any;
+    InputDefinition: any;
+    StateValues: any;
+    ConfigValues: any;
+    InputValues: any;
+    OutputValues: any;
+}
+export type CompiledGraphFor<T extends string> = T extends keyof IGraphTypeRegistry ? CompiledStateGraph<IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["State"], string, IGraphTypeRegistry[T]["Input"], IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["Config"]> : CompiledStateGraph<any, any, string, any, any, any>;
+export interface IGraphBuilder<T extends string> {
+    buildGraph(config?: any): Promise<CompiledGraphFor<T>>;
+}
+export interface IGraphCompiler {
+    getConfiguredGraph<T extends string>(type: T, thread?: any): Promise<CompiledGraphFor<T>>;
+}
+export type BaseGraphState = {};
+export interface IGraphMetadata {
+    userId: string;
+    applicationId: string;
+    workflowType: string;
+    version: string;
+}
+export interface IGraphConfigurable<TGraphSettings = any> {
+    thread_id?: string;
+    metadata?: IGraphMetadata;
+    graphSettings: TGraphSettings;
+}
+export type IGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<IGraphConfigurable<TGraphSettings>> & {
+    configurable: IGraphConfigurable<TGraphSettings>;
+};
+export type StrictGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<TGraphSettings> & {
+    configurable: IGraphConfigurable<TGraphSettings>;
+};
+export interface LLMConfig {
+    modelId: string;
+    temperature?: number;
+    maxTokens?: number;
+    prompt?: string;
+}
+export interface IGraphTypeMetadata {
+    type: string;
+    metadata: {
+        title: string;
+        description: string;
+        detailedDescription: string;
+        icon?: string;
+        recommendations?: string[];
+        tags?: string[];
+        category?: string;
+    };
+    schema: {
+        properties: Record<string, any>;
+        required: string[];
+    };
+    defaultSettings: any;
+    formFields?: any[];
+}
+export type IGraphMetadataRegistry = Record<string, IGraphTypeMetadata>;
+export { StreamChannel } from "../shared-types";

package/dist/types/graph-types.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamChannel = void 0;
+var shared_types_1 = require("../shared-types");
+Object.defineProperty(exports, "StreamChannel", { enumerable: true, get: function () { return shared_types_1.StreamChannel; } });
+//# sourceMappingURL=graph-types.js.map

package/dist/types/graph-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.js","sourceRoot":"","sources":["../../src/types/graph-types.ts"],"names":[],"mappings":";;;AA6IA,gDAAgD;AAAvC,6GAAA,aAAa,OAAA"}

package/dist/utils/error.utils.d.ts

@@ -0,0 +1,18 @@
+export declare function isError(error: unknown): error is Error;
+export declare function getErrorMessage(error: unknown): string;
+export declare function getErrorStack(error: unknown): string | undefined;
+export declare function formatError(error: unknown): {
+    message: string;
+    stack?: string;
+    code?: string;
+    statusCode?: number;
+    details?: any;
+};
+export declare function formatErrorForProduction(error: unknown): {
+    message: string;
+    code?: string;
+    statusCode?: number;
+};
+export declare function logError(logger: {
+    error: (message: string, ...args: any[]) => void;
+}, error: unknown, context: string, additionalData?: Record<string, any>): void;

package/dist/utils/error.utils.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isError = isError;
+exports.getErrorMessage = getErrorMessage;
+exports.getErrorStack = getErrorStack;
+exports.formatError = formatError;
+exports.formatErrorForProduction = formatErrorForProduction;
+exports.logError = logError;
+function isError(error) {
+    return error instanceof Error;
+}
+function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    if (typeof error === "object" && error !== null) {
+        if ("message" in error && typeof error.message === "string") {
+            return error.message;
+        }
+        return JSON.stringify(error);
+    }
+    return String(error);
+}
+function getErrorStack(error) {
+    if (error instanceof Error)
+        return error.stack;
+    if (typeof error === "object" && error !== null && "stack" in error) {
+        return String(error.stack);
+    }
+    return undefined;
+}
+function formatError(error) {
+    if (error instanceof Error) {
+        const formatted = {
+            message: error.message,
+            stack: error.stack,
+        };
+        if ("code" in error)
+            formatted.code = error.code;
+        if ("statusCode" in error)
+            formatted.statusCode = error.statusCode;
+        if ("response" in error)
+            formatted.details = error.response;
+        return formatted;
+    }
+    if (typeof error === "string") {
+        return { message: error };
+    }
+    if (typeof error === "object" && error !== null) {
+        const formatted = {
+            message: "message" in error && typeof error.message === "string"
+                ? error.message
+                : JSON.stringify(error),
+        };
+        if ("stack" in error)
+            formatted.stack = String(error.stack);
+        if ("code" in error)
+            formatted.code = String(error.code);
+        if ("statusCode" in error && typeof error.statusCode === "number") {
+            formatted.statusCode = error.statusCode;
+        }
+        return formatted;
+    }
+    return { message: String(error) };
+}
+function formatErrorForProduction(error) {
+    const formatted = formatError(error);
+    delete formatted.stack;
+    delete formatted.details;
+    return formatted;
+}
+function logError(logger, error, context, additionalData) {
+    const errorInfo = formatError(error);
+    logger.error(context, process.env.ENV === "prod"
+        ? Object.assign(Object.assign({}, formatErrorForProduction(error)), additionalData) : Object.assign(Object.assign({}, errorInfo), additionalData));
+}
+//# sourceMappingURL=error.utils.js.map

package/dist/utils/error.utils.js.map

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

package/dist/utils/graph-type.utils.d.ts

@@ -0,0 +1,14 @@
+export declare class GraphTypeUtils {
+    static parse(fullType: string): {
+        companyId: string;
+        name: string;
+        version?: string;
+    };
+    static build(companyId: string, name: string, version?: string): string;
+    static normalize(graphType: string): string;
+    static getBaseType(graphType: string): string;
+    static getVersion(graphType: string): string | undefined;
+    static isValidVersion(version: string): boolean;
+    static isSystemGraph(graphType: string): boolean;
+    static compareVersions(a: string, b: string): number;
+}

package/dist/utils/graph-type.utils.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphTypeUtils = void 0;
+class GraphTypeUtils {
+    static parse(fullType) {
+        if (fullType.includes("::")) {
+            const [baseType, version] = fullType.split("::");
+            const [companyId, name] = baseType.split(".");
+            return { companyId, name, version };
+        }
+        const parts = fullType.split(".");
+        if (parts.length === 1) {
+            return { companyId: "global", name: parts[0] };
+        }
+        return { companyId: parts[0], name: parts[1] };
+    }
+    static build(companyId, name, version) {
+        const base = `${companyId}.${name}`;
+        return version ? `${base}::${version}` : base;
+    }
+    static normalize(graphType) {
+        const { companyId, name, version } = this.parse(graphType);
+        return this.build(companyId, name, version);
+    }
+    static getBaseType(graphType) {
+        if (graphType.includes("::")) {
+            return graphType.split("::")[0];
+        }
+        const { companyId, name } = this.parse(graphType);
+        return `${companyId}.${name}`;
+    }
+    static getVersion(graphType) {
+        return graphType.includes("::") ? graphType.split("::")[1] : undefined;
+    }
+    static isValidVersion(version) {
+        const semverRegex = /^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?$/;
+        return semverRegex.test(version);
+    }
+    static isSystemGraph(graphType) {
+        const { companyId } = this.parse(graphType);
+        return companyId === "global";
+    }
+    static compareVersions(a, b) {
+        const parseVersion = (v) => {
+            const [main, prerelease] = v.split("-");
+            const [major, minor, patch] = main.split(".").map(Number);
+            return { major, minor, patch, prerelease };
+        };
+        const versionA = parseVersion(a);
+        const versionB = parseVersion(b);
+        if (versionA.major !== versionB.major) {
+            return versionA.major - versionB.major;
+        }
+        if (versionA.minor !== versionB.minor) {
+            return versionA.minor - versionB.minor;
+        }
+        if (versionA.patch !== versionB.patch) {
+            return versionA.patch - versionB.patch;
+        }
+        if (versionA.prerelease && !versionB.prerelease)
+            return -1;
+        if (!versionA.prerelease && versionB.prerelease)
+            return 1;
+        if (versionA.prerelease && versionB.prerelease) {
+            return versionA.prerelease.localeCompare(versionB.prerelease);
+        }
+        return 0;
+    }
+}
+exports.GraphTypeUtils = GraphTypeUtils;
+//# sourceMappingURL=graph-type.utils.js.map

package/dist/utils/graph-type.utils.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./graph-type.utils";

package/dist/utils/index.js

@@ -0,0 +1,18 @@
+"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("./graph-type.utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,qDAAmC"}

package/dist/utils/usage-recorder.d.ts

@@ -0,0 +1,23 @@
+export declare class UsageRecorder {
+    private modelCalls;
+    recordModelExecution(record: {
+        modelId: string;
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens?: number;
+        [key: string]: any;
+    }): void;
+    getRecords(): {
+        modelCalls: Array<{
+            modelId: string;
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+            timestamp: string;
+            [key: string]: any;
+        }>;
+    };
+    clear(): void;
+    getTotalTokens(): number;
+    getTotalCalls(): number;
+}

package/dist/utils/usage-recorder.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageRecorder = void 0;
+class UsageRecorder {
+    constructor() {
+        this.modelCalls = [];
+    }
+    recordModelExecution(record) {
+        var _a;
+        const totalTokens = (_a = record.totalTokens) !== null && _a !== void 0 ? _a : record.promptTokens + record.completionTokens;
+        this.modelCalls.push(Object.assign(Object.assign({}, record), { totalTokens, timestamp: new Date().toISOString() }));
+    }
+    getRecords() {
+        return {
+            modelCalls: [...this.modelCalls],
+        };
+    }
+    clear() {
+        this.modelCalls = [];
+    }
+    getTotalTokens() {
+        return this.modelCalls.reduce((sum, call) => sum + call.totalTokens, 0);
+    }
+    getTotalCalls() {
+        return this.modelCalls.length;
+    }
+}
+exports.UsageRecorder = UsageRecorder;
+//# sourceMappingURL=usage-recorder.js.map

package/dist/utils/usage-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-recorder.js","sourceRoot":"","sources":["../../src/utils/usage-recorder.ts"],"names":[],"mappings":";;;AAGA,MAAa,aAAa;IAA1B;QACU,eAAU,GAOb,EAAE,CAAC;IA4CV,CAAC;IA1CC,oBAAoB,CAAC,MAMpB;;QACC,MAAM,WAAW,GACf,MAAA,MAAM,CAAC,WAAW,mCAAI,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACtE,IAAI,CAAC,UAAU,CAAC,IAAI,iCACf,MAAM,KACT,WAAW,EACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IACnC,CAAC;IACL,CAAC;IAED,UAAU;QAUR,OAAO;YACL,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;SACjC,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;CACF;AApDD,sCAoDC"}

package/dist/versioning/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./versioned-graph.service";
+export * from "./versioning.types";

package/dist/versioning/index.js

@@ -0,0 +1,19 @@
+"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("./versioned-graph.service"), exports);
+__exportStar(require("./versioning.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/versioning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,4DAA0C;AAC1C,qDAAmC"}

package/dist/versioning/versioned-graph.service.d.ts

@@ -0,0 +1,16 @@
+import { ModuleRef } from "@nestjs/core";
+import { AbstractGraphBuilder } from "../core/abstract-graph.builder";
+import { VersioningConfig, VersionResolution, VersionResolutionOptions } from "./versioning.types";
+export declare class VersionedGraphService {
+    private readonly logger;
+    private readonly versionConfigs;
+    constructor();
+    registerVersioning(config: VersioningConfig): void;
+    resolveVersion(graphType: string, options?: VersionResolutionOptions): Promise<VersionResolution>;
+    createVersionedBuilder(graphType: string, moduleRef?: ModuleRef, options?: VersionResolutionOptions): Promise<AbstractGraphBuilder<any>>;
+    getAvailableVersions(baseGraphType: string): string[];
+    isVersionSupported(graphType: string, options?: VersionResolutionOptions): boolean;
+    private findBestVersionRoute;
+    private isVersionCompatible;
+    getVersioningInfo(baseGraphType: string): VersioningConfig | null;
+}

package/dist/versioning/versioned-graph.service.js

@@ -0,0 +1,132 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var VersionedGraphService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionedGraphService = void 0;
+const common_1 = require("@nestjs/common");
+const graph_type_utils_1 = require("../utils/graph-type.utils");
+let VersionedGraphService = VersionedGraphService_1 = class VersionedGraphService {
+    constructor() {
+        this.logger = new common_1.Logger(VersionedGraphService_1.name);
+        this.versionConfigs = new Map();
+    }
+    registerVersioning(config) {
+        this.versionConfigs.set(config.baseGraphType, config);
+        this.logger.log(`Registered versioning for ${config.baseGraphType} with ${config.versions.length} versions`);
+    }
+    async resolveVersion(graphType, options = {}) {
+        const parsed = graph_type_utils_1.GraphTypeUtils.parse(graphType);
+        const baseType = graph_type_utils_1.GraphTypeUtils.getBaseType(graphType);
+        const requestedVersion = graph_type_utils_1.GraphTypeUtils.getVersion(graphType) || options.requestedVersion;
+        const config = this.versionConfigs.get(baseType);
+        if (!config) {
+            throw new Error(`No versioning configuration found for ${baseType}`);
+        }
+        const route = this.findBestVersionRoute(config, requestedVersion, options);
+        if (!route) {
+            throw new Error(`No compatible version found for ${graphType} with options: ${JSON.stringify(options)}`);
+        }
+        const fullGraphType = graph_type_utils_1.GraphTypeUtils.build(parsed.companyId, parsed.name, route.version);
+        return {
+            version: route.version,
+            builderClass: route.builderClass,
+            fullGraphType,
+        };
+    }
+    async createVersionedBuilder(graphType, moduleRef, options = {}) {
+        const resolution = await this.resolveVersion(graphType, options);
+        try {
+            if (!moduleRef) {
+                throw new Error("ModuleRef is not available - falling back to direct instantiation");
+            }
+            const builder = await moduleRef.create(resolution.builderClass);
+            this.logger.debug(`Created versioned builder for ${resolution.fullGraphType}`);
+            return builder;
+        }
+        catch (error) {
+            this.logger.error(`Failed to create builder for ${resolution.fullGraphType}: ${error.message}`);
+            throw new Error(`Failed to create versioned builder: ${error.message}`);
+        }
+    }
+    getAvailableVersions(baseGraphType) {
+        const config = this.versionConfigs.get(baseGraphType);
+        if (!config) {
+            return [];
+        }
+        return config.versions
+            .map(route => route.version)
+            .sort((a, b) => graph_type_utils_1.GraphTypeUtils.compareVersions(b, a));
+    }
+    isVersionSupported(graphType, options = {}) {
+        try {
+            const baseType = graph_type_utils_1.GraphTypeUtils.getBaseType(graphType);
+            const requestedVersion = graph_type_utils_1.GraphTypeUtils.getVersion(graphType);
+            const config = this.versionConfigs.get(baseType);
+            if (!config) {
+                return false;
+            }
+            const route = this.findBestVersionRoute(config, requestedVersion, options);
+            return route !== null;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    findBestVersionRoute(config, requestedVersion, options = {}) {
+        const { strict = false } = options;
+        let candidates = [...config.versions];
+        if (requestedVersion) {
+            const exactMatch = candidates.find(route => route.version === requestedVersion);
+            if (exactMatch) {
+                return exactMatch;
+            }
+            if (strict) {
+                return null;
+            }
+            const compatibleVersions = candidates.filter(route => this.isVersionCompatible(requestedVersion, route.version));
+            if (compatibleVersions.length > 0) {
+                return compatibleVersions.sort((a, b) => graph_type_utils_1.GraphTypeUtils.compareVersions(b.version, a.version))[0];
+            }
+        }
+        const defaultRoute = candidates.find(route => route.isDefault);
+        if (defaultRoute) {
+            return defaultRoute;
+        }
+        if (config.defaultVersionStrategy === "latest" ||
+            !config.defaultVersionStrategy) {
+            const sortedVersions = candidates.sort((a, b) => graph_type_utils_1.GraphTypeUtils.compareVersions(b.version, a.version));
+            return sortedVersions[0] || null;
+        }
+        return null;
+    }
+    isVersionCompatible(requested, available) {
+        try {
+            const requestedParts = requested.split(".").map(Number);
+            const availableParts = available.split(".").map(Number);
+            if (requestedParts[0] !== availableParts[0]) {
+                return false;
+            }
+            return graph_type_utils_1.GraphTypeUtils.compareVersions(available, requested) >= 0;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    getVersioningInfo(baseGraphType) {
+        return this.versionConfigs.get(baseGraphType) || null;
+    }
+};
+exports.VersionedGraphService = VersionedGraphService;
+exports.VersionedGraphService = VersionedGraphService = VersionedGraphService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], VersionedGraphService);
+//# sourceMappingURL=versioned-graph.service.js.map

package/dist/versioning/versioned-graph.service.js.map

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

package/dist/versioning/versioning.types.d.ts

@@ -0,0 +1,21 @@
+import { Type } from "@nestjs/common";
+import { AbstractGraphBuilder } from "../core/abstract-graph.builder";
+export interface VersionRoute {
+    version: string;
+    builderClass: Type<AbstractGraphBuilder<any>>;
+    isDefault?: boolean;
+}
+export interface VersioningConfig {
+    baseGraphType: string;
+    versions: VersionRoute[];
+    defaultVersionStrategy?: "latest" | "explicit";
+}
+export interface VersionResolution {
+    version: string;
+    builderClass: Type<AbstractGraphBuilder<any>>;
+    fullGraphType: string;
+}
+export interface VersionResolutionOptions {
+    requestedVersion?: string;
+    strict?: boolean;
+}

package/dist/versioning/versioning.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=versioning.types.js.map

package/dist/versioning/versioning.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.types.js","sourceRoot":"","sources":["../../src/versioning/versioning.types.ts"],"names":[],"mappings":""}