@relayfile/adapter-core 0.3.5 → 0.3.7

package/dist/src/digest/index.d.ts

@@ -0,0 +1,50 @@
+export interface DigestWindow {
+    readonly from: string;
+    readonly to: string;
+}
+export interface DigestChangeEvent {
+    readonly id?: string;
+    readonly timestamp?: string;
+    readonly occurredAt?: string;
+    readonly eventType?: string;
+    readonly type?: string;
+    readonly action?: string;
+    readonly canonicalPath?: string;
+    readonly path?: string;
+}
+export interface DigestContext {
+    readonly provider: string;
+    readonly window: DigestWindow;
+    changeEvents(filter?: {
+        providers?: string[];
+        paths?: string[];
+    }): Promise<readonly DigestChangeEvent[]>;
+}
+export interface DigestBullet {
+    readonly text: string;
+    readonly canonicalPath: string;
+}
+export interface DigestSection {
+    readonly provider: string;
+    readonly bullets: readonly DigestBullet[];
+}
+export type DigestHandler = (ctx: DigestContext) => Promise<DigestSection | null>;
+export interface DigestActionRule {
+    readonly verbs: string;
+    readonly pastTense: string;
+}
+export interface DigestAliasConfig {
+    readonly mode?: "parent-scoped" | "any";
+    readonly segments?: readonly string[];
+    readonly parentSegments?: readonly string[];
+}
+export interface CreateDigestHandlerOptions {
+    readonly provider?: string;
+    readonly pathPrefix?: string;
+    readonly identify: (canonicalPath: string) => string;
+    readonly actionRules?: readonly DigestActionRule[];
+    readonly defaultPastTense?: string;
+    readonly alias?: DigestAliasConfig;
+}
+export declare function createDigestHandler(options: CreateDigestHandlerOptions): DigestHandler;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/digest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/digest/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,YAAY,CAAC,MAAM,CAAC,EAAE;QACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,KAAK,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AA4CD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa,CA2BtF"}

package/dist/src/digest/index.js

@@ -0,0 +1,138 @@
+const DEFAULT_ALIAS_SEGMENTS = new Set([
+    "by-assignee",
+    "by-creator",
+    "by-day",
+    "by-database",
+    "by-folder",
+    "by-id",
+    "by-key",
+    "by-name",
+    "by-parent",
+    "by-priority",
+    "by-ref",
+    "by-space",
+    "by-state",
+    "by-status",
+    "by-title",
+    "by-uuid",
+]);
+const DEFAULT_PARENT_SEGMENTS = new Set([
+    "channels",
+    "commits",
+    "databases",
+    "deployments",
+    "issues",
+    "pages",
+    "pipelines",
+    "projects",
+    "pulls",
+    "sprints",
+    "spaces",
+    "tags",
+    "tasks",
+    "teams",
+    "users",
+]);
+export function createDigestHandler(options) {
+    const compiledRules = compileActionRules(options.actionRules ?? []);
+    const defaultPastTense = options.defaultPastTense ?? "was updated";
+    const aliasMode = options.alias?.mode ?? "parent-scoped";
+    const aliasSegments = new Set(options.alias?.segments ?? DEFAULT_ALIAS_SEGMENTS);
+    const aliasParents = new Set(options.alias?.parentSegments ?? DEFAULT_PARENT_SEGMENTS);
+    return async (ctx) => {
+        const provider = options.provider ?? ctx.provider;
+        const prefix = normalizeDigestPath(options.pathPrefix ?? provider);
+        const events = await ctx.changeEvents({ providers: [ctx.provider] });
+        const bullets = events
+            .filter((event) => hasDigestPath(event, prefix, provider, aliasMode, aliasSegments, aliasParents))
+            .slice()
+            .sort(compareEvents)
+            .map((event) => {
+            const canonicalPath = normalizeDigestPath(digestEventPath(event));
+            return {
+                text: `${options.identify(canonicalPath)} ${pastTense(event, compiledRules, defaultPastTense)}`,
+                canonicalPath,
+            };
+        });
+        return bullets.length === 0 ? null : { provider: ctx.provider, bullets };
+    };
+}
+function hasDigestPath(event, prefix, provider, aliasMode, aliasSegments, aliasParents) {
+    const eventPath = digestEventPath(event);
+    if (!eventPath || !isCanonicalDigestPath(eventPath, provider, aliasMode, aliasSegments, aliasParents)) {
+        return false;
+    }
+    return (eventPath === prefix
+        || eventPath === `/${prefix}`
+        || eventPath.startsWith(`${prefix}/`)
+        || eventPath.startsWith(`/${prefix}/`));
+}
+function isCanonicalDigestPath(path, provider, aliasMode, aliasSegments, aliasParents) {
+    const segments = normalizeDigestPath(path).split("/").filter(Boolean);
+    const leaf = segments.at(-1) ?? "";
+    return (leaf !== "LAYOUT.md" &&
+        leaf !== "_index.json" &&
+        !hasDigestAliasDirectory(segments, provider, aliasMode, aliasSegments, aliasParents));
+}
+function hasDigestAliasDirectory(segments, provider, aliasMode, aliasSegments, aliasParents) {
+    if ((segments[0] ?? "") !== provider)
+        return false;
+    for (let index = 1; index < segments.length - 1; index += 1) {
+        const segment = segments[index];
+        if (!segment || !aliasSegments.has(segment))
+            continue;
+        if (aliasMode === "any")
+            return true;
+        const parent = segments[index - 1];
+        if (parent && aliasParents.has(parent)) {
+            return true;
+        }
+    }
+    return false;
+}
+function compareEvents(left, right) {
+    const leftMs = eventTimeMs(left);
+    const rightMs = eventTimeMs(right);
+    return (leftMs - rightMs ||
+        compareDigestStrings(left.id ?? "", right.id ?? "") ||
+        compareDigestStrings(digestEventPath(left), digestEventPath(right)));
+}
+function compareDigestStrings(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function eventTime(event) {
+    return event.timestamp ?? event.occurredAt ?? "";
+}
+function eventTimeMs(event) {
+    const raw = eventTime(event);
+    if (!raw)
+        return Number.NEGATIVE_INFINITY;
+    const ms = Date.parse(raw);
+    return Number.isNaN(ms) ? Number.NEGATIVE_INFINITY : ms;
+}
+function digestEventPath(event) {
+    return event.canonicalPath ?? event.path ?? "";
+}
+function normalizeDigestPath(path) {
+    return path.replace(/^\/+/u, "");
+}
+function pastTense(event, rules, defaultPastTense) {
+    const action = (event.action ?? event.eventType ?? event.type ?? "").toLowerCase();
+    for (const rule of rules) {
+        if (rule.regex.test(action)) {
+            return rule.pastTense;
+        }
+    }
+    return defaultPastTense;
+}
+function compileActionRules(rules) {
+    return rules.map((rule) => ({
+        regex: new RegExp(`(^|[^a-z0-9])(${rule.verbs})([^a-z0-9]|$)`, "u"),
+        pastTense: rule.pastTense,
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/src/digest/index.js.map

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

package/dist/src/digest/index.test.d.ts

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

package/dist/src/digest/index.test.d.ts.map

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

package/dist/src/digest/index.test.js

@@ -0,0 +1,68 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createDigestHandler, } from "./index.js";
+test("createDigestHandler emits sorted bullets and filters alias/index/layout paths", async () => {
+    const digest = createDigestHandler({
+        provider: "alpha",
+        identify: (path) => path.split("/").at(-1) ?? path,
+        actionRules: [
+            { verbs: "create|created", pastTense: "was created" },
+            { verbs: "delete|deleted", pastTense: "was deleted" },
+        ],
+    });
+    const ctx = {
+        provider: "alpha",
+        window: { from: "2026-01-01T00:00:00.000Z", to: "2026-01-02T00:00:00.000Z" },
+        async changeEvents(filter) {
+            assert.deepEqual(filter, { providers: ["alpha"] });
+            return [
+                { id: "2", timestamp: "2026-01-01T09:00:00.000Z", action: "updated", canonicalPath: "/alpha/issues/by-id/ISS-1.json" },
+                { id: "1", timestamp: "2026-01-01T08:00:00.000Z", action: "created", canonicalPath: "/alpha/issues/ISS-1.json" },
+                { id: "3", timestamp: "2026-01-01T10:00:00.000Z", action: "deleted", canonicalPath: "/alpha/issues/_index.json" },
+                { id: "4", timestamp: "2026-01-01T11:00:00.000Z", action: "deleted", canonicalPath: "/alpha/LAYOUT.md" },
+            ];
+        },
+    };
+    assert.deepEqual(await digest(ctx), {
+        provider: "alpha",
+        bullets: [
+            {
+                text: "ISS-1.json was created",
+                canonicalPath: "alpha/issues/ISS-1.json",
+            },
+        ],
+    });
+});
+test("createDigestHandler supports provider aliases with alias.mode=any", async () => {
+    const digest = createDigestHandler({
+        provider: "beta",
+        identify: (path) => path,
+        alias: {
+            mode: "any",
+            segments: ["by-folder"],
+        },
+        actionRules: [
+            { verbs: "archive|archived", pastTense: "was archived" },
+        ],
+    });
+    const ctx = {
+        provider: "beta",
+        window: { from: "2026-01-01T00:00:00.000Z", to: "2026-01-02T00:00:00.000Z" },
+        async changeEvents() {
+            return [
+                { id: "1", timestamp: "2026-01-01T08:00:00.000Z", action: "archived", canonicalPath: "/beta/notes/not_1.json" },
+                { id: "2", timestamp: "2026-01-01T09:00:00.000Z", action: "archived", canonicalPath: "/beta/notes/by-folder/fol_1/_index.json" },
+            ];
+        },
+    };
+    assert.deepEqual(await digest(ctx), {
+        provider: "beta",
+        bullets: [
+            {
+                text: "beta/notes/not_1.json was archived",
+                canonicalPath: "beta/notes/not_1.json",
+            },
+        ],
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/src/digest/index.test.js.map

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

package/dist/src/index.d.ts

@@ -22,6 +22,7 @@ export * from "./docs/updater.js";
 export * from "./storage-bridge/index.js";
 export * from "./atomic-index/index.js";
 export * from "./emit-auxiliary/index.js";
+export * from "./digest/index.js";
 export * from "./alias-slug.js";
 export * from "./layout-contract.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/src/index.js

@@ -22,6 +22,7 @@ export * from "./docs/updater.js";
 export * from "./storage-bridge/index.js";
 export * from "./atomic-index/index.js";
 export * from "./emit-auxiliary/index.js";
+export * from "./digest/index.js";
 export * from "./alias-slug.js";
 export * from "./layout-contract.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/adapter-core",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Schema-driven relayfile adapter generator and runtime",
   "type": "module",
   "main": "dist/src/index.js",