@modyo/mcp 0.1.0

package/build/shared/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./clients/index.js";
+export * from "./context/sessionContext.js";
+export { FetchRepositoryBase } from "./FetchRepositoryBase.js";
+export * from "./globals/index.js";
+export * from "./helpers/index.js";
+export { McpServerBase } from "./McpServerBase.js";
+export { PromptBase } from "./PromptBase.js";
+export { ResourceBase } from "./ResourceBase.js";
+export { ToolBase } from "./ToolBase.js";
+export * from "./test-utils/index.js";
+export * from "./tools/index.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/build/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AAEnC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,kBAAkB,CAAC"}

package/build/shared/index.js

@@ -0,0 +1,20 @@
+// Base classes
+// Clients
+export * from "./clients/index.js";
+// Context utilities
+export * from "./context/sessionContext.js";
+export { FetchRepositoryBase } from "./FetchRepositoryBase.js";
+export * from "./globals/index.js";
+// Re-export helper functions
+export * from "./helpers/index.js";
+export { McpServerBase } from "./McpServerBase.js";
+export { PromptBase } from "./PromptBase.js";
+export { ResourceBase } from "./ResourceBase.js";
+export { ToolBase } from "./ToolBase.js";
+// Test utilities
+export * from "./test-utils/index.js";
+// Shared tools
+export * from "./tools/index.js";
+// Types (includes runtime exports like assetTypes)
+export * from "./types/index.js";
+//# sourceMappingURL=index.js.map

package/build/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,UAAU;AACV,cAAc,oBAAoB,CAAC;AACnC,oBAAoB;AACpB,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,oBAAoB,CAAC;AACnC,6BAA6B;AAC7B,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,iBAAiB;AACjB,cAAc,uBAAuB,CAAC;AACtC,eAAe;AACf,cAAc,kBAAkB,CAAC;AACjC,mDAAmD;AACnD,cAAc,kBAAkB,CAAC"}

package/build/shared/providers/SinglePlatformProvider.d.ts

@@ -0,0 +1,13 @@
+import type { PlatformConfig } from "../types/Logger.js";
+export declare class SinglePlatformProvider {
+    private static instance;
+    private config;
+    private constructor();
+    static getInstance(): SinglePlatformProvider;
+    private loadFromEnv;
+    getPlatform(): PlatformConfig | null;
+    listPlatforms(): PlatformConfig[];
+    isConfigured(): boolean;
+}
+export declare const singlePlatformProvider: SinglePlatformProvider;
+//# sourceMappingURL=SinglePlatformProvider.d.ts.map

package/build/shared/providers/SinglePlatformProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SinglePlatformProvider.d.ts","sourceRoot":"","sources":["../../../src/shared/providers/SinglePlatformProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyB;IAChD,OAAO,CAAC,MAAM,CAA+B;IAE7C,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAO5C,OAAO,CAAC,WAAW;IAiBnB,WAAW,IAAI,cAAc,GAAG,IAAI;IAIpC,aAAa,IAAI,cAAc,EAAE;IAQjC,YAAY,IAAI,OAAO;CAGxB;AAED,eAAO,MAAM,sBAAsB,wBAAuC,CAAC"}

package/build/shared/providers/SinglePlatformProvider.js

@@ -0,0 +1,42 @@
+export class SinglePlatformProvider {
+    static instance;
+    config = null;
+    constructor() {
+        this.loadFromEnv();
+    }
+    static getInstance() {
+        if (!SinglePlatformProvider.instance) {
+            SinglePlatformProvider.instance = new SinglePlatformProvider();
+        }
+        return SinglePlatformProvider.instance;
+    }
+    loadFromEnv() {
+        const url = process.env.MODYO_URL;
+        const token = process.env.MODYO_TOKEN;
+        const name = process.env.MODYO_PLATFORM_NAME || "default";
+        if (!url || !token) {
+            return;
+        }
+        this.config = {
+            slug: "default",
+            name,
+            url,
+            token,
+        };
+    }
+    getPlatform() {
+        return this.config;
+    }
+    listPlatforms() {
+        return this.config
+            ? [
+                this.config,
+            ]
+            : [];
+    }
+    isConfigured() {
+        return this.config !== null;
+    }
+}
+export const singlePlatformProvider = SinglePlatformProvider.getInstance();
+//# sourceMappingURL=SinglePlatformProvider.js.map

package/build/shared/providers/SinglePlatformProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SinglePlatformProvider.js","sourceRoot":"","sources":["../../../src/shared/providers/SinglePlatformProvider.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAC,QAAQ,CAAyB;IACxC,MAAM,GAA0B,IAAI,CAAC;IAE7C;QACE,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,CAAC;YACrC,sBAAsB,CAAC,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,sBAAsB,CAAC,QAAQ,CAAC;IACzC,CAAC;IAEO,WAAW;QACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS,CAAC;QAE1D,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,SAAS;YACf,IAAI;YACJ,GAAG;YACH,KAAK;SACN,CAAC;IACJ,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM;YAChB,CAAC,CAAC;gBACE,IAAI,CAAC,MAAM;aACZ;YACH,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC,WAAW,EAAE,CAAC"}

package/build/shared/test-utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./toolTestUtils.js";
+//# sourceMappingURL=index.d.ts.map

package/build/shared/test-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/test-utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/build/shared/test-utils/index.js

@@ -0,0 +1,2 @@
+export * from "./toolTestUtils.js";
+//# sourceMappingURL=index.js.map

package/build/shared/test-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/test-utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/build/shared/test-utils/toolTestUtils.d.ts

@@ -0,0 +1,191 @@
+import { type Mock, vi } from "vitest";
+import type { Logger } from "../types/Logger.js";
+/**
+ * Test utilities for MCP tool testing
+ *
+ * These utilities provide common mocking patterns for testing MCP tools,
+ * reducing boilerplate and ensuring consistency across tests.
+ *
+ * Features:
+ * - Mock creators for server, organizations, logger
+ * - Result extractors and parsers
+ * - Parametrized test case helpers
+ * - Test fixtures via test.extend pattern
+ */
+export { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi, } from "vitest";
+export interface MockServer {
+    registerTool: Mock;
+    server: {
+        elicitInput: Mock;
+    };
+}
+/**
+ * Creates a mock MCP server with registerTool spy
+ */
+export declare function createMockServer(): MockServer;
+/**
+ * Creates a mock logger function
+ */
+export declare function createMockLogger(): Logger;
+/**
+ * Creates a mock repository with specified methods
+ */
+export declare function createMockRepository<T extends Record<string, unknown>>(methods: {
+    [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? ReturnType<typeof vi.fn> : never;
+}): T;
+/**
+ * Extracts the tool handler function from a mock server's registerTool calls
+ */
+export declare function extractToolHandler(mockServer: MockServer, callIndex?: number): (params: unknown) => Promise<unknown>;
+/**
+ * Extracts tool metadata from registerTool call
+ */
+export declare function extractToolMetadata(mockServer: MockServer, callIndex?: number): {
+    name: string;
+    description: unknown;
+    inputSchema: unknown;
+    annotations: unknown;
+};
+/**
+ * Helper to assert CallToolResult structure
+ */
+export declare function isCallToolResult(result: unknown): boolean;
+/**
+ * Helper to extract text content from CallToolResult
+ */
+export declare function extractResultText(result: unknown): string;
+/**
+ * Helper to parse JSON from CallToolResult text
+ */
+export declare function parseResultJSON<T = unknown>(result: unknown): T;
+export interface ToolTestSetup {
+    server: MockServer;
+    logger: Logger;
+    extractHandler: (callIndex?: number) => (params: unknown) => Promise<unknown>;
+    extractMetadata: (callIndex?: number) => {
+        name: string;
+        description: unknown;
+        inputSchema: unknown;
+        annotations: unknown;
+    };
+}
+/**
+ * Creates a complete test setup with all common mocks
+ */
+export declare function setupToolTest(): ToolTestSetup;
+/**
+ * Test case type for validation tests
+ */
+export interface ValidationTestCase {
+    name: string;
+    input: Record<string, unknown>;
+    expectedError?: string;
+}
+/**
+ * Test case type for query parameter tests
+ */
+export interface QueryParamTestCase {
+    description: string;
+    params: Record<string, unknown>;
+    expectedCall?: Record<string, unknown>;
+}
+/**
+ * Test case type for ID iteration tests
+ */
+export interface IdIterationTestCase<T = unknown> {
+    id: number;
+    expectedResult?: T;
+    description?: string;
+}
+/**
+ * Standard pagination test cases for reuse across tests
+ */
+export declare const STANDARD_PAGINATION_CASES: QueryParamTestCase[];
+/**
+ * Standard ID iteration test cases
+ */
+export declare const STANDARD_ID_CASES: number[];
+/**
+ * Standard query filter test cases
+ */
+export declare const STANDARD_QUERY_CASES: QueryParamTestCase[];
+/**
+ * Combines pagination and query cases for comprehensive list testing
+ */
+export declare const STANDARD_LIST_CASES: QueryParamTestCase[];
+/**
+ * Standard status filter cases for job/task filtering
+ */
+export declare const STANDARD_STATUS_CASES: ({
+    status: "pending";
+    description: string;
+} | {
+    status: "processing";
+    description: string;
+} | {
+    status: "completed";
+    description: string;
+} | {
+    status: "failed";
+    description: string;
+})[];
+/**
+ * Standard action test cases for CRUD operations
+ */
+export declare const STANDARD_ACTION_CASES: ({
+    action: "list";
+    description: string;
+} | {
+    action: "get";
+    description: string;
+} | {
+    action: "create";
+    description: string;
+} | {
+    action: "update";
+    description: string;
+} | {
+    action: "delete";
+    description: string;
+})[];
+/**
+ * Test fixtures interface for type-safe fixture access
+ */
+export interface ToolTestFixtures {
+    /** Pre-configured mock MCP server */
+    server: MockServer;
+    /** Pre-configured mock logger */
+    logger: Logger;
+    /** Complete test setup with extractors */
+    testSetup: ToolTestSetup;
+}
+/**
+ * Extended test with common fixtures for MCP tool testing.
+ * Use this instead of base `test` when you need server and logger fixtures.
+ *
+ * @example
+ * ```typescript
+ * import { test, expect, describe } from "./index.js";
+ *
+ * describe("MyTool", () => {
+ *   test("should register tool", async ({ server, logger }) => {
+ *     MyTool.registerTool(server, "mcp-test", logger);
+ *     expect(server.registerTool).toHaveBeenCalled();
+ *   });
+ *
+ *   // Or use the complete testSetup
+ *   test("should handle request", async ({ testSetup }) => {
+ *     MyTool.registerTool(testSetup.server, "mcp-test", testSetup.logger);
+ *     const handler = testSetup.extractHandler();
+ *     const result = await handler({ action: "list" });
+ *     expect(result).toBeDefined();
+ *   });
+ * });
+ * ```
+ */
+export declare const test: import("vitest").TestAPI<{
+    server: MockServer;
+    logger: Logger;
+    testSetup: ToolTestSetup;
+}>;
+//# sourceMappingURL=toolTestUtils.d.ts.map

package/build/shared/test-utils/toolTestUtils.d.ts.map

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

package/build/shared/test-utils/toolTestUtils.js

@@ -0,0 +1,304 @@
+import { test as baseTest, vi } from "vitest";
+/**
+ * Test utilities for MCP tool testing
+ *
+ * These utilities provide common mocking patterns for testing MCP tools,
+ * reducing boilerplate and ensuring consistency across tests.
+ *
+ * Features:
+ * - Mock creators for server, organizations, logger
+ * - Result extractors and parsers
+ * - Parametrized test case helpers
+ * - Test fixtures via test.extend pattern
+ */
+// Re-export vitest utilities for convenience
+export { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi, } from "vitest";
+// ============================================
+// MOCK CREATORS
+// ============================================
+/**
+ * Creates a mock MCP server with registerTool spy
+ */
+export function createMockServer() {
+    return {
+        registerTool: vi.fn(),
+        server: {
+            elicitInput: vi.fn(),
+        },
+    };
+}
+/**
+ * Creates a mock logger function
+ */
+export function createMockLogger() {
+    return vi.fn();
+}
+/**
+ * Creates a mock repository with specified methods
+ */
+export function createMockRepository(methods) {
+    return methods;
+}
+// ============================================
+// EXTRACTORS
+// ============================================
+/**
+ * Extracts the tool handler function from a mock server's registerTool calls
+ */
+export function extractToolHandler(mockServer, callIndex = 0) {
+    const calls = mockServer.registerTool.mock.calls;
+    if (calls.length === 0) {
+        throw new Error("registerTool was not called on the mock server");
+    }
+    if (callIndex >= calls.length) {
+        throw new Error(`Call index ${callIndex} out of bounds (${calls.length} calls made)`);
+    }
+    const handler = calls[callIndex]?.[2];
+    if (!handler || typeof handler !== "function") {
+        throw new Error("Handler function not found in registerTool call");
+    }
+    return handler;
+}
+/**
+ * Extracts tool metadata from registerTool call
+ */
+export function extractToolMetadata(mockServer, callIndex = 0) {
+    const calls = mockServer.registerTool.mock.calls;
+    if (calls.length === 0 || callIndex >= calls.length) {
+        throw new Error("Invalid call index or no calls made");
+    }
+    const [name, metadata] = calls[callIndex];
+    return {
+        name,
+        description: metadata.description,
+        inputSchema: metadata.inputSchema,
+        annotations: metadata.annotations,
+    };
+}
+// ============================================
+// RESULT HELPERS
+// ============================================
+/**
+ * Helper to assert CallToolResult structure
+ */
+export function isCallToolResult(result) {
+    if (!result || typeof result !== "object")
+        return false;
+    const r = result;
+    return (Array.isArray(r.content) &&
+        r.content.every((item) => typeof item === "object" &&
+            item !== null &&
+            "type" in item &&
+            "text" in item));
+}
+/**
+ * Helper to extract text content from CallToolResult
+ */
+export function extractResultText(result) {
+    if (!result || typeof result !== "object") {
+        throw new Error("Invalid result object");
+    }
+    const r = result;
+    if (!Array.isArray(r.content)) {
+        throw new Error("Result does not have content array");
+    }
+    return r.content.map((item) => item.text ?? "").join("\n");
+}
+/**
+ * Helper to parse JSON from CallToolResult text
+ */
+export function parseResultJSON(result) {
+    const text = extractResultText(result);
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse result JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Creates a complete test setup with all common mocks
+ */
+export function setupToolTest() {
+    const server = createMockServer();
+    const logger = createMockLogger();
+    return {
+        server,
+        logger,
+        extractHandler: (callIndex = 0) => extractToolHandler(server, callIndex),
+        extractMetadata: (callIndex = 0) => extractToolMetadata(server, callIndex),
+    };
+}
+/**
+ * Standard pagination test cases for reuse across tests
+ */
+export const STANDARD_PAGINATION_CASES = [
+    {
+        description: "page only",
+        params: {
+            page: 2,
+        },
+        expectedCall: {
+            page: 2,
+        },
+    },
+    {
+        description: "per_page only",
+        params: {
+            per_page: 50,
+        },
+        expectedCall: {
+            per_page: 50,
+        },
+    },
+    {
+        description: "page and per_page",
+        params: {
+            page: 3,
+            per_page: 25,
+        },
+        expectedCall: {
+            page: 3,
+            per_page: 25,
+        },
+    },
+];
+/**
+ * Standard ID iteration test cases
+ */
+export const STANDARD_ID_CASES = [
+    1,
+    42,
+    999,
+];
+/**
+ * Standard query filter test cases
+ */
+export const STANDARD_QUERY_CASES = [
+    {
+        description: "search query",
+        params: {
+            query: "test-search",
+        },
+        expectedCall: {
+            query: "test-search",
+        },
+    },
+    {
+        description: "sorting ascending",
+        params: {
+            sort_by: "name",
+            order: "asc",
+        },
+        expectedCall: {
+            sort_by: "name",
+            order: "asc",
+        },
+    },
+    {
+        description: "sorting descending",
+        params: {
+            sort_by: "created_at",
+            order: "desc",
+        },
+        expectedCall: {
+            sort_by: "created_at",
+            order: "desc",
+        },
+    },
+];
+/**
+ * Combines pagination and query cases for comprehensive list testing
+ */
+export const STANDARD_LIST_CASES = [
+    ...STANDARD_PAGINATION_CASES,
+    ...STANDARD_QUERY_CASES,
+];
+/**
+ * Standard status filter cases for job/task filtering
+ */
+export const STANDARD_STATUS_CASES = [
+    {
+        status: "pending",
+        description: "pending items",
+    },
+    {
+        status: "processing",
+        description: "processing items",
+    },
+    {
+        status: "completed",
+        description: "completed items",
+    },
+    {
+        status: "failed",
+        description: "failed items",
+    },
+];
+/**
+ * Standard action test cases for CRUD operations
+ */
+export const STANDARD_ACTION_CASES = [
+    {
+        action: "list",
+        description: "list action",
+    },
+    {
+        action: "get",
+        description: "get action",
+    },
+    {
+        action: "create",
+        description: "create action",
+    },
+    {
+        action: "update",
+        description: "update action",
+    },
+    {
+        action: "delete",
+        description: "delete action",
+    },
+];
+/**
+ * Extended test with common fixtures for MCP tool testing.
+ * Use this instead of base `test` when you need server and logger fixtures.
+ *
+ * @example
+ * ```typescript
+ * import { test, expect, describe } from "./index.js";
+ *
+ * describe("MyTool", () => {
+ *   test("should register tool", async ({ server, logger }) => {
+ *     MyTool.registerTool(server, "mcp-test", logger);
+ *     expect(server.registerTool).toHaveBeenCalled();
+ *   });
+ *
+ *   // Or use the complete testSetup
+ *   test("should handle request", async ({ testSetup }) => {
+ *     MyTool.registerTool(testSetup.server, "mcp-test", testSetup.logger);
+ *     const handler = testSetup.extractHandler();
+ *     const result = await handler({ action: "list" });
+ *     expect(result).toBeDefined();
+ *   });
+ * });
+ * ```
+ */
+export const test = baseTest.extend({
+    // biome-ignore lint/correctness/noEmptyPattern: Required by Vitest extend API
+    server: async ({}, use) => {
+        const mockServer = createMockServer();
+        await use(mockServer);
+    },
+    // biome-ignore lint/correctness/noEmptyPattern: Required by Vitest extend API
+    logger: async ({}, use) => {
+        const mockLogger = createMockLogger();
+        await use(mockLogger);
+    },
+    // biome-ignore lint/correctness/noEmptyPattern: Required by Vitest extend API
+    testSetup: async ({}, use) => {
+        const setup = setupToolTest();
+        await use(setup);
+    },
+});
+//# sourceMappingURL=toolTestUtils.js.map

package/build/shared/test-utils/toolTestUtils.js.map

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

package/build/shared/tools/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/shared/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC"}

package/build/shared/tools/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/build/shared/tools/index.js.map

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

package/build/shared/types/AssetExtensions.d.ts

@@ -0,0 +1,15 @@
+import z from "zod";
+export declare const assetExtensions: {
+    picture: string[];
+    audio: string[];
+    file: string[];
+    video: string[];
+};
+export declare const assetTypes: z.ZodEnum<{
+    audio: "audio";
+    file: "file";
+    picture: "picture";
+    video: "video";
+}>;
+export type AssetType = z.infer<typeof assetTypes>;
+//# sourceMappingURL=AssetExtensions.d.ts.map

package/build/shared/types/AssetExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetExtensions.d.ts","sourceRoot":"","sources":["../../../src/shared/types/AssetExtensions.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;CAqF3B,CAAC;AAGF,eAAO,MAAM,UAAU;;;;;EAKrB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}