@voyantjs/action-ledger 0.52.2

package/dist/timeline.d.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import type { ActionLedgerEntry } from "./schema.js";
+export type ActionLedgerTimelineCursor = {
+    occurredAt: string;
+    id: string;
+};
+export type ActionLedgerSerializedEntry = Omit<ActionLedgerEntry, "occurredAt" | "createdAt"> & {
+    occurredAt: string;
+    createdAt: string;
+};
+export type ActionLedgerTargetTimelineEntry = ActionLedgerSerializedEntry & {
+    mutationSummary: string | null;
+};
+export interface ActionLedgerTargetTimelinePage {
+    data: ActionLedgerTargetTimelineEntry[];
+    pageInfo: {
+        nextCursor: ActionLedgerTimelineCursor | null;
+    };
+}
+export declare const actionLedgerTargetTimelineQuerySchema: z.ZodPipe<z.ZodObject<{
+    cursorOccurredAt: z.ZodOptional<z.ZodString>;
+    cursorId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>, z.ZodTransform<{
+    cursor: {
+        occurredAt: string;
+        id: string;
+    } | undefined;
+    limit?: number | undefined;
+}, {
+    cursorOccurredAt?: string | undefined;
+    cursorId?: string | undefined;
+    limit?: number | undefined;
+}>>;
+export type ActionLedgerTargetTimelineQuery = z.infer<typeof actionLedgerTargetTimelineQuerySchema>;
+export declare function serializeActionLedgerDate(value: Date | string): string;
+export declare function serializeActionLedgerEntry(entry: ActionLedgerEntry): ActionLedgerSerializedEntry;
+export declare function toActionLedgerTimelineCursor(entry: Pick<ActionLedgerEntry, "occurredAt" | "id">): ActionLedgerTimelineCursor;
+export declare function sortActionLedgerTimelineEntries(entries: ActionLedgerEntry[]): ActionLedgerEntry[];
+export declare function buildActionLedgerTargetTimelinePage({ entries, limit, mutationSummariesByActionId, }: {
+    entries: ActionLedgerEntry[];
+    limit: number;
+    mutationSummariesByActionId?: ReadonlyMap<string, string | null>;
+}): ActionLedgerTargetTimelinePage;
+export declare const __test__: {
+    actionLedgerTargetTimelineQuerySchema: z.ZodPipe<z.ZodObject<{
+        cursorOccurredAt: z.ZodOptional<z.ZodString>;
+        cursorId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, z.ZodTransform<{
+        cursor: {
+            occurredAt: string;
+            id: string;
+        } | undefined;
+        limit?: number | undefined;
+    }, {
+        cursorOccurredAt?: string | undefined;
+        cursorId?: string | undefined;
+        limit?: number | undefined;
+    }>>;
+    buildActionLedgerTargetTimelinePage: typeof buildActionLedgerTargetTimelinePage;
+    serializeActionLedgerDate: typeof serializeActionLedgerDate;
+    serializeActionLedgerEntry: typeof serializeActionLedgerEntry;
+    sortActionLedgerTimelineEntries: typeof sortActionLedgerTimelineEntries;
+    toActionLedgerTimelineCursor: typeof toActionLedgerTimelineCursor;
+};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,WAAW,CAAC,GAAG;IAC9F,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG,2BAA2B,GAAG;IAC1E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,+BAA+B,EAAE,CAAA;IACvC,QAAQ,EAAE;QACR,UAAU,EAAE,0BAA0B,GAAG,IAAI,CAAA;KAC9C,CAAA;CACF;AAED,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;GAwB7C,CAAA;AAEL,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAA;AAEnG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,2BAA2B,CAMhG;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,IAAI,CAAC,GAClD,0BAA0B,CAK5B;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAMjG;AAED,wBAAgB,mCAAmC,CAAC,EAClD,OAAO,EACP,KAAK,EACL,2BAAuC,GACxC,EAAE;IACD,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;CACjE,GAAG,8BAA8B,CAoBjC;AAED,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;CAOpB,CAAA"}

package/dist/timeline.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+export const actionLedgerTargetTimelineQuerySchema = z
+    .object({
+    cursorOccurredAt: z.string().datetime().optional(),
+    cursorId: z.string().trim().min(1).optional(),
+    limit: z.coerce.number().int().min(1).max(199).optional(),
+})
+    .superRefine((value, ctx) => {
+    if (Boolean(value.cursorOccurredAt) === Boolean(value.cursorId))
+        return;
+    ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: value.cursorOccurredAt ? ["cursorId"] : ["cursorOccurredAt"],
+        message: "cursorOccurredAt and cursorId must be provided together",
+    });
+})
+    .transform(({ cursorOccurredAt, cursorId, ...query }) => ({
+    ...query,
+    cursor: cursorOccurredAt && cursorId
+        ? {
+            occurredAt: cursorOccurredAt,
+            id: cursorId,
+        }
+        : undefined,
+}));
+export function serializeActionLedgerDate(value) {
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new Error("Action ledger timeline timestamp must be a valid date");
+    }
+    return date.toISOString();
+}
+export function serializeActionLedgerEntry(entry) {
+    return {
+        ...entry,
+        occurredAt: serializeActionLedgerDate(entry.occurredAt),
+        createdAt: serializeActionLedgerDate(entry.createdAt),
+    };
+}
+export function toActionLedgerTimelineCursor(entry) {
+    return {
+        occurredAt: serializeActionLedgerDate(entry.occurredAt),
+        id: entry.id,
+    };
+}
+export function sortActionLedgerTimelineEntries(entries) {
+    return [...entries].sort((a, b) => {
+        const occurredAtDelta = new Date(b.occurredAt).getTime() - new Date(a.occurredAt).getTime();
+        if (occurredAtDelta !== 0)
+            return occurredAtDelta;
+        return b.id.localeCompare(a.id);
+    });
+}
+export function buildActionLedgerTargetTimelinePage({ entries, limit, mutationSummariesByActionId = new Map(), }) {
+    const entriesById = new Map();
+    for (const entry of entries) {
+        entriesById.set(entry.id, entry);
+    }
+    const sortedEntries = sortActionLedgerTimelineEntries([...entriesById.values()]);
+    const visibleEntries = sortedEntries.slice(0, limit);
+    const lastEntry = visibleEntries.at(-1);
+    return {
+        data: visibleEntries.map((entry) => ({
+            ...serializeActionLedgerEntry(entry),
+            mutationSummary: mutationSummariesByActionId.get(entry.id) ?? null,
+        })),
+        pageInfo: {
+            nextCursor: sortedEntries.length > limit && lastEntry ? toActionLedgerTimelineCursor(lastEntry) : null,
+        },
+    };
+}
+export const __test__ = {
+    actionLedgerTargetTimelineQuerySchema,
+    buildActionLedgerTargetTimelinePage,
+    serializeActionLedgerDate,
+    serializeActionLedgerEntry,
+    sortActionLedgerTimelineEntries,
+    toActionLedgerTimelineCursor,
+};

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@voyantjs/action-ledger",
+  "version": "0.52.2",
+  "description": "Action ledger schema, append-only write helpers, and idempotency primitives for Voyant control surfaces.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./canary": "./src/canary.ts",
+    "./capability": "./src/capability.ts",
+    "./schema": "./src/schema.ts",
+    "./service": "./src/service.ts",
+    "./fingerprint": "./src/fingerprint.ts",
+    "./timeline": "./src/timeline.ts",
+    "./request-context": "./src/request-context.ts",
+    "./routes": "./src/routes.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/ tests/",
+    "test": "vitest run --passWithNoTests",
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "prepack": "pnpm run build"
+  },
+  "dependencies": {
+    "@voyantjs/core": "workspace:*",
+    "@voyantjs/db": "workspace:*",
+    "@voyantjs/hono": "workspace:*",
+    "drizzle-orm": "^0.45.2",
+    "hono": "^4.12.10",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@voyantjs/voyant-typescript-config": "workspace:*",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./canary": {
+        "types": "./dist/canary.d.ts",
+        "import": "./dist/canary.js",
+        "default": "./dist/canary.js"
+      },
+      "./capability": {
+        "types": "./dist/capability.d.ts",
+        "import": "./dist/capability.js",
+        "default": "./dist/capability.js"
+      },
+      "./schema": {
+        "types": "./dist/schema.d.ts",
+        "import": "./dist/schema.js",
+        "default": "./dist/schema.js"
+      },
+      "./service": {
+        "types": "./dist/service.d.ts",
+        "import": "./dist/service.js",
+        "default": "./dist/service.js"
+      },
+      "./fingerprint": {
+        "types": "./dist/fingerprint.d.ts",
+        "import": "./dist/fingerprint.js",
+        "default": "./dist/fingerprint.js"
+      },
+      "./timeline": {
+        "types": "./dist/timeline.d.ts",
+        "import": "./dist/timeline.js",
+        "default": "./dist/timeline.js"
+      },
+      "./request-context": {
+        "types": "./dist/request-context.d.ts",
+        "import": "./dist/request-context.js",
+        "default": "./dist/request-context.js"
+      },
+      "./routes": {
+        "types": "./dist/routes.d.ts",
+        "import": "./dist/routes.js",
+        "default": "./dist/routes.js"
+      }
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyantjs/voyant.git",
+    "directory": "packages/action-ledger"
+  },
+  "voyant": {
+    "schema": "./schema",
+    "requiresSchemas": [
+      "@voyantjs/db"
+    ]
+  }
+}