daycare-cli 0.0.0-canary.00a24ac

package/dist/storage/tasksRepository.spec.js

@@ -0,0 +1,158 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { contextForAgent } from "../engine/agents/context.js";
+import { storageOpenTest } from "./storageOpenTest.js";
+import { TasksRepository } from "./tasksRepository.js";
+describe("TasksRepository", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("supports create, find, update, and delete", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const repo = new TasksRepository(storage.db);
+            const ctx = contextForAgent({ userId: "user-1", agentId: "agent-1" });
+            const record = {
+                id: "task-1",
+                userId: "user-1",
+                version: 1,
+                validFrom: 10,
+                validTo: null,
+                title: "Daily report",
+                description: "Summarize yesterday",
+                code: "print('hello')",
+                parameters: null,
+                createdAt: 10,
+                updatedAt: 10
+            };
+            await repo.create(record);
+            const byId = await repo.findById(ctx, "task-1");
+            expect(byId).toEqual(record);
+            const byUser = await repo.findMany(ctx);
+            expect(byUser).toHaveLength(1);
+            expect(byUser[0]?.id).toBe("task-1");
+            vi.spyOn(Date, "now").mockReturnValue(20);
+            await repo.update(ctx, "task-1", {
+                title: "Daily report updated",
+                code: "print('updated')",
+                updatedAt: 20
+            });
+            const updated = await repo.findById(ctx, "task-1");
+            expect(updated?.title).toBe("Daily report updated");
+            expect(updated?.code).toBe("print('updated')");
+            expect(updated?.updatedAt).toBe(20);
+            expect(await repo.delete(ctx, "task-1")).toBe(true);
+            expect(await repo.delete(ctx, "task-1")).toBe(false);
+            expect(await repo.findById(ctx, "task-1")).toBeNull();
+            const deleted = await repo.findAnyById(ctx, "task-1");
+            expect(deleted?.id).toBe("task-1");
+            expect(typeof deleted?.validTo).toBe("number");
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("returns cached task on repeated read", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const repo = new TasksRepository(storage.db);
+            const ctx = contextForAgent({ userId: "user-1", agentId: "agent-1" });
+            await repo.create({
+                id: "cached-task",
+                userId: "user-1",
+                version: 1,
+                validFrom: 1,
+                validTo: null,
+                title: "Cache",
+                description: null,
+                code: "print('cache')",
+                parameters: null,
+                createdAt: 1,
+                updatedAt: 1
+            });
+            const first = await repo.findById(ctx, "cached-task");
+            expect(first?.id).toBe("cached-task");
+            storage.connection.prepare("DELETE FROM tasks WHERE user_id = ? AND id = ?").run(ctx.userId, "cached-task");
+            const second = await repo.findById(ctx, "cached-task");
+            expect(second?.id).toBe("cached-task");
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("scopes ids by user", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const repo = new TasksRepository(storage.db);
+            const ctxA = contextForAgent({ userId: "user-1", agentId: "agent-1" });
+            const ctxB = contextForAgent({ userId: "user-2", agentId: "agent-2" });
+            await repo.create({
+                id: "task-shared",
+                userId: "user-1",
+                version: 1,
+                validFrom: 1,
+                validTo: null,
+                title: "A",
+                description: null,
+                code: "print('a')",
+                parameters: null,
+                createdAt: 1,
+                updatedAt: 1
+            });
+            await repo.create({
+                id: "task-shared",
+                userId: "user-2",
+                version: 1,
+                validFrom: 2,
+                validTo: null,
+                title: "B",
+                description: null,
+                code: "print('b')",
+                parameters: null,
+                createdAt: 2,
+                updatedAt: 2
+            });
+            const first = await repo.findById(ctxA, "task-shared");
+            const second = await repo.findById(ctxB, "task-shared");
+            expect(first?.title).toBe("A");
+            expect(second?.title).toBe("B");
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("loads specific historical task versions", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const repo = new TasksRepository(storage.db);
+            const ctx = contextForAgent({ userId: "user-1", agentId: "agent-1" });
+            await repo.create({
+                id: "task-history",
+                userId: "user-1",
+                version: 1,
+                validFrom: 1,
+                validTo: null,
+                title: "Task v1",
+                description: null,
+                code: "print('v1')",
+                parameters: null,
+                createdAt: 1,
+                updatedAt: 1
+            });
+            await repo.update(ctx, "task-history", {
+                title: "Task v2",
+                code: "print('v2')",
+                updatedAt: 2
+            });
+            const version1 = await repo.findByVersion(ctx, "task-history", 1);
+            const version2 = await repo.findByVersion(ctx, "task-history", 2);
+            const version3 = await repo.findByVersion(ctx, "task-history", 3);
+            expect(version1?.code).toBe("print('v1')");
+            expect(version2?.code).toBe("print('v2')");
+            expect(version3).toBeNull();
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+});
+//# sourceMappingURL=tasksRepository.spec.js.map

package/dist/storage/tasksRepository.spec.js.map

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

package/dist/storage/tokenStatsRepository.d.ts

@@ -0,0 +1,32 @@
+import type { Context } from "@/types";
+import type { DaycareDb } from "../schema.js";
+import type { TokenStatsHourlyDbRecord } from "./databaseTypes.js";
+export type TokenStatsIncrementInput = {
+    at?: number;
+    model: string;
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    cost: number;
+};
+export type TokenStatsFindManyOptions = {
+    from?: number;
+    to?: number;
+    userId?: string;
+    agentId?: string;
+    model?: string;
+    limit?: number;
+};
+/**
+ * Repository for hourly token/cost rollups keyed by user, agent, and model.
+ * Expects: schema migrations already applied for token_stats_hourly.
+ */
+export declare class TokenStatsRepository {
+    private readonly db;
+    constructor(db: DaycareDb);
+    increment(ctx: Context, input: TokenStatsIncrementInput): Promise<void>;
+    findMany(ctx: Context, options?: Omit<TokenStatsFindManyOptions, "userId">): Promise<TokenStatsHourlyDbRecord[]>;
+    findAll(options?: TokenStatsFindManyOptions): Promise<TokenStatsHourlyDbRecord[]>;
+}
+//# sourceMappingURL=tokenStatsRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenStatsRepository.d.ts","sourceRoot":"","sources":["../../sources/storage/tokenStatsRepository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAInE,MAAM,MAAM,wBAAwB,GAAG;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;gBAEnB,EAAE,EAAE,SAAS;IAInB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CvE,QAAQ,CACV,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,QAAQ,CAAM,GACxD,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAShC,OAAO,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;CA0C9F"}

package/dist/storage/tokenStatsRepository.js

@@ -0,0 +1,150 @@
+import { and, asc, eq, gte, lte, sql } from "drizzle-orm";
+import { tokenStatsHourlyTable } from "../schema.js";
+const HOUR_MS = 60 * 60 * 1000;
+/**
+ * Repository for hourly token/cost rollups keyed by user, agent, and model.
+ * Expects: schema migrations already applied for token_stats_hourly.
+ */
+export class TokenStatsRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async increment(ctx, input) {
+        const model = input.model.trim();
+        if (model.length === 0) {
+            return;
+        }
+        const inputTokens = numberTokenNormalize(input.input);
+        const outputTokens = numberTokenNormalize(input.output);
+        const cacheReadTokens = numberTokenNormalize(input.cacheRead);
+        const cacheWriteTokens = numberTokenNormalize(input.cacheWrite);
+        const cost = numberCostNormalize(input.cost);
+        if (inputTokens === 0 && outputTokens === 0 && cacheReadTokens === 0 && cacheWriteTokens === 0 && cost <= 0) {
+            return;
+        }
+        const hourStart = hourStartResolve(input.at ?? Date.now());
+        await this.db
+            .insert(tokenStatsHourlyTable)
+            .values({
+            hourStart,
+            userId: ctx.userId,
+            agentId: ctx.agentId,
+            model,
+            inputTokens,
+            outputTokens,
+            cacheReadTokens,
+            cacheWriteTokens,
+            cost
+        })
+            .onConflictDoUpdate({
+            target: [
+                tokenStatsHourlyTable.hourStart,
+                tokenStatsHourlyTable.userId,
+                tokenStatsHourlyTable.agentId,
+                tokenStatsHourlyTable.model
+            ],
+            set: {
+                inputTokens: sql `${tokenStatsHourlyTable.inputTokens} + ${sql.raw("excluded.input_tokens")}`,
+                outputTokens: sql `${tokenStatsHourlyTable.outputTokens} + ${sql.raw("excluded.output_tokens")}`,
+                cacheReadTokens: sql `${tokenStatsHourlyTable.cacheReadTokens} + ${sql.raw("excluded.cache_read_tokens")}`,
+                cacheWriteTokens: sql `${tokenStatsHourlyTable.cacheWriteTokens} + ${sql.raw("excluded.cache_write_tokens")}`,
+                cost: sql `${tokenStatsHourlyTable.cost} + ${sql.raw("excluded.cost")}`
+            }
+        });
+    }
+    async findMany(ctx, options = {}) {
+        const agentId = options.agentId ?? (ctx.hasAgentId === true ? ctx.agentId : undefined);
+        return this.findAll({
+            ...options,
+            userId: ctx.userId,
+            agentId
+        });
+    }
+    async findAll(options = {}) {
+        const conditions = [];
+        const from = options.from === undefined ? undefined : hourStartResolve(options.from);
+        const to = options.to === undefined ? undefined : hourStartResolve(options.to);
+        const userId = options.userId?.trim();
+        const agentId = options.agentId?.trim();
+        const model = options.model?.trim();
+        if (from !== undefined) {
+            conditions.push(gte(tokenStatsHourlyTable.hourStart, from));
+        }
+        if (to !== undefined) {
+            conditions.push(lte(tokenStatsHourlyTable.hourStart, to));
+        }
+        if (userId) {
+            conditions.push(eq(tokenStatsHourlyTable.userId, userId));
+        }
+        if (agentId) {
+            conditions.push(eq(tokenStatsHourlyTable.agentId, agentId));
+        }
+        if (model) {
+            conditions.push(eq(tokenStatsHourlyTable.model, model));
+        }
+        const whereClause = conditions.length > 0 ? and(...conditions) : undefined;
+        const limit = numberLimitResolve(options.limit);
+        const baseQuery = this.db
+            .select()
+            .from(tokenStatsHourlyTable)
+            .where(whereClause)
+            .orderBy(asc(tokenStatsHourlyTable.hourStart), asc(tokenStatsHourlyTable.userId), asc(tokenStatsHourlyTable.agentId), asc(tokenStatsHourlyTable.model));
+        const rows = limit !== null ? await baseQuery.limit(limit) : await baseQuery;
+        return rows.map((row) => rowParse(row));
+    }
+}
+function rowParse(row) {
+    return {
+        hourStart: numberTokenNormalize(row.hourStart),
+        userId: row.userId,
+        agentId: row.agentId,
+        model: row.model,
+        input: numberTokenNormalize(row.inputTokens),
+        output: numberTokenNormalize(row.outputTokens),
+        cacheRead: numberTokenNormalize(row.cacheReadTokens),
+        cacheWrite: numberTokenNormalize(row.cacheWriteTokens),
+        cost: numberCostNormalize(row.cost)
+    };
+}
+function numberTokenNormalize(value) {
+    const parsed = numberParse(value);
+    if (parsed === null) {
+        return 0;
+    }
+    return Math.max(0, Math.trunc(parsed));
+}
+function numberCostNormalize(value) {
+    const parsed = numberParse(value);
+    if (parsed === null) {
+        return 0;
+    }
+    return Math.max(0, parsed);
+}
+function hourStartResolve(value) {
+    return Math.floor(value / HOUR_MS) * HOUR_MS;
+}
+function numberLimitResolve(value) {
+    if (value === undefined) {
+        return null;
+    }
+    if (!Number.isFinite(value)) {
+        return null;
+    }
+    return Math.max(1, Math.floor(value));
+}
+function numberParse(value) {
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : null;
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed.length === 0) {
+            return null;
+        }
+        const parsed = Number(trimmed);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+//# sourceMappingURL=tokenStatsRepository.js.map

package/dist/storage/tokenStatsRepository.js.map

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

package/dist/storage/tokenStatsRepository.spec.d.ts

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

package/dist/storage/tokenStatsRepository.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenStatsRepository.spec.d.ts","sourceRoot":"","sources":["../../sources/storage/tokenStatsRepository.spec.ts"],"names":[],"mappings":""}

package/dist/storage/tokenStatsRepository.spec.js

@@ -0,0 +1,220 @@
+import { describe, expect, it, vi } from "vitest";
+import { contextForUser } from "../engine/agents/context.js";
+import { agentsTable, usersTable } from "../schema.js";
+import { storageOpenTest } from "./storageOpenTest.js";
+import { TokenStatsRepository } from "./tokenStatsRepository.js";
+async function createTestEntities(storage, users, agents) {
+    for (const userId of users) {
+        await storage.db.insert(usersTable).values({
+            id: userId,
+            version: 1,
+            validFrom: 1,
+            validTo: null,
+            nametag: `tag-${userId}`,
+            isOwner: false,
+            createdAt: 1,
+            updatedAt: 1
+        });
+    }
+    for (const agentId of agents) {
+        await storage.db.insert(agentsTable).values({
+            id: agentId,
+            version: 1,
+            validFrom: 1,
+            validTo: null,
+            userId: users[0] ?? "user-a",
+            path: `/${users[0] ?? "user-a"}/cron/${agentId}`,
+            foreground: false,
+            name: agentId,
+            description: null,
+            systemPrompt: null,
+            workspaceDir: null,
+            nextSubIndex: 0,
+            activeSessionId: null,
+            permissions: { workingDir: "/tmp", writeDirs: ["/tmp"] },
+            lifecycle: "active",
+            createdAt: 1,
+            updatedAt: 1
+        });
+    }
+}
+describe("TokenStatsRepository", () => {
+    it("increments hourly rows and merges by hour/user/agent/model", async () => {
+        const storage = await storageOpenTest();
+        try {
+            await createTestEntities(storage, ["user-a"], ["agent-a"]);
+            const repository = new TokenStatsRepository(storage.db);
+            const ctx = ctxBuild("user-a", "agent-a");
+            const hour = Date.UTC(2026, 1, 26, 9, 12, 0, 0);
+            await repository.increment(ctx, {
+                at: hour,
+                model: "openai/gpt-5-mini",
+                input: 10,
+                output: 4,
+                cacheRead: 2,
+                cacheWrite: 1,
+                cost: 0.25
+            });
+            await repository.increment(ctx, {
+                at: hour + 30_000,
+                model: "openai/gpt-5-mini",
+                input: 1,
+                output: 3,
+                cacheRead: 4,
+                cacheWrite: 5,
+                cost: 0.05
+            });
+            const rows = await repository.findAll();
+            expect(rows).toHaveLength(1);
+            expect(rows[0]).toEqual({
+                hourStart: Date.UTC(2026, 1, 26, 9, 0, 0, 0),
+                userId: "user-a",
+                agentId: "agent-a",
+                model: "openai/gpt-5-mini",
+                input: 11,
+                output: 7,
+                cacheRead: 6,
+                cacheWrite: 6,
+                cost: 0.3
+            });
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("filters rows by range and identity", async () => {
+        const storage = await storageOpenTest();
+        try {
+            await createTestEntities(storage, ["user-a", "user-b"], ["agent-a", "agent-b", "agent-c"]);
+            const repository = new TokenStatsRepository(storage.db);
+            await repository.increment(ctxBuild("user-a", "agent-a"), {
+                at: Date.UTC(2026, 1, 26, 8, 5, 0, 0),
+                model: "anthropic/claude-sonnet-4-5",
+                input: 10,
+                output: 1,
+                cacheRead: 0,
+                cacheWrite: 0,
+                cost: 0.2
+            });
+            await repository.increment(ctxBuild("user-a", "agent-b"), {
+                at: Date.UTC(2026, 1, 26, 9, 5, 0, 0),
+                model: "openai/gpt-5",
+                input: 2,
+                output: 3,
+                cacheRead: 1,
+                cacheWrite: 1,
+                cost: 0.1
+            });
+            await repository.increment(ctxBuild("user-b", "agent-c"), {
+                at: Date.UTC(2026, 1, 26, 10, 5, 0, 0),
+                model: "openai/gpt-5",
+                input: 9,
+                output: 9,
+                cacheRead: 9,
+                cacheWrite: 9,
+                cost: 0.9
+            });
+            const range = await repository.findAll({
+                from: Date.UTC(2026, 1, 26, 9, 0, 0, 0),
+                to: Date.UTC(2026, 1, 26, 10, 59, 0, 0)
+            });
+            expect(range).toHaveLength(2);
+            const byUser = await repository.findAll({ userId: "user-a" });
+            expect(byUser).toHaveLength(2);
+            expect(byUser.every((row) => row.userId === "user-a")).toBe(true);
+            const byAgent = await repository.findAll({ agentId: "agent-b" });
+            expect(byAgent).toHaveLength(1);
+            expect(byAgent[0]?.agentId).toBe("agent-b");
+            const byModel = await repository.findAll({ model: "openai/gpt-5" });
+            expect(byModel).toHaveLength(2);
+            expect(byModel.every((row) => row.model === "openai/gpt-5")).toBe(true);
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("findMany works for user context without agentId", async () => {
+        const storage = await storageOpenTest();
+        try {
+            await createTestEntities(storage, ["user-a", "user-b"], ["agent-a", "agent-b"]);
+            const repository = new TokenStatsRepository(storage.db);
+            await repository.increment(ctxBuild("user-a", "agent-a"), {
+                at: Date.UTC(2026, 1, 26, 8, 5, 0, 0),
+                model: "openai/gpt-5",
+                input: 10,
+                output: 1,
+                cacheRead: 0,
+                cacheWrite: 0,
+                cost: 0.2
+            });
+            await repository.increment(ctxBuild("user-a", "agent-b"), {
+                at: Date.UTC(2026, 1, 26, 9, 5, 0, 0),
+                model: "openai/gpt-5-mini",
+                input: 2,
+                output: 3,
+                cacheRead: 1,
+                cacheWrite: 1,
+                cost: 0.1
+            });
+            await repository.increment(ctxBuild("user-b", "agent-a"), {
+                at: Date.UTC(2026, 1, 26, 10, 5, 0, 0),
+                model: "openai/gpt-5",
+                input: 9,
+                output: 9,
+                cacheRead: 9,
+                cacheWrite: 9,
+                cost: 0.9
+            });
+            const rows = await repository.findMany(contextForUser({ userId: "user-a" }));
+            expect(rows).toHaveLength(2);
+            expect(rows.every((row) => row.userId === "user-a")).toBe(true);
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("coerces numeric string rows from db drivers into numeric token stats", async () => {
+        const dbRows = [
+            {
+                hourStart: 1772326800000,
+                userId: "user-a",
+                agentId: "agent-a",
+                model: "google/gemini-2.5-flash",
+                inputTokens: "1316725",
+                outputTokens: "5923245",
+                cacheReadTokens: "0",
+                cacheWriteTokens: "",
+                cost: "3.25"
+            }
+        ];
+        const baseQuery = {
+            where: vi.fn().mockReturnThis(),
+            orderBy: vi.fn().mockReturnThis(),
+            limit: vi.fn(async () => dbRows)
+        };
+        const db = {
+            select: vi.fn(() => ({
+                from: vi.fn(() => baseQuery)
+            }))
+        };
+        const repository = new TokenStatsRepository(db);
+        const rows = await repository.findAll({ limit: 1 });
+        expect(rows).toEqual([
+            {
+                hourStart: 1772326800000,
+                userId: "user-a",
+                agentId: "agent-a",
+                model: "google/gemini-2.5-flash",
+                input: 1316725,
+                output: 5923245,
+                cacheRead: 0,
+                cacheWrite: 0,
+                cost: 3.25
+            }
+        ]);
+    });
+});
+function ctxBuild(userId, agentId) {
+    return { userId, agentId };
+}
+//# sourceMappingURL=tokenStatsRepository.spec.js.map

package/dist/storage/tokenStatsRepository.spec.js.map

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

package/dist/storage/userConnectorKeyCreate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates a stable connector identity key from connector + connector user id.
+ * Expects: connector and userId are non-empty strings after trim.
+ */
+export declare function userConnectorKeyCreate(connector: string, userId: string): string;
+//# sourceMappingURL=userConnectorKeyCreate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userConnectorKeyCreate.d.ts","sourceRoot":"","sources":["../../sources/storage/userConnectorKeyCreate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUhF"}

package/dist/storage/userConnectorKeyCreate.js

@@ -0,0 +1,16 @@
+/**
+ * Creates a stable connector identity key from connector + connector user id.
+ * Expects: connector and userId are non-empty strings after trim.
+ */
+export function userConnectorKeyCreate(connector, userId) {
+    const normalizedConnector = connector.trim();
+    const normalizedUserId = userId.trim();
+    if (!normalizedConnector) {
+        throw new Error("Connector is required");
+    }
+    if (!normalizedUserId) {
+        throw new Error("Connector userId is required");
+    }
+    return `${normalizedConnector}:${normalizedUserId}`;
+}
+//# sourceMappingURL=userConnectorKeyCreate.js.map

package/dist/storage/userConnectorKeyCreate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userConnectorKeyCreate.js","sourceRoot":"","sources":["../../sources/storage/userConnectorKeyCreate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,MAAc;IACpE,MAAM,mBAAmB,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,mBAAmB,IAAI,gBAAgB,EAAE,CAAC;AACxD,CAAC"}

package/dist/storage/userConnectorKeyCreate.spec.d.ts

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

package/dist/storage/userConnectorKeyCreate.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userConnectorKeyCreate.spec.d.ts","sourceRoot":"","sources":["../../sources/storage/userConnectorKeyCreate.spec.ts"],"names":[],"mappings":""}