@agent-native/creative-context 0.3.0 → 0.5.0

package/src/client/actions.spec.ts

@@ -0,0 +1,177 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  parseContextMemberships,
+  parseContextMembershipsForResource,
+  parseCreativeContextSafePreview,
+  parseCreativeContexts,
+} from "./actions.js";
+
+describe("creative context client action contracts", () => {
+  it("accepts the canonical list result and tolerates an array result", () => {
+    const context = {
+      id: "context-1",
+      name: "Campaign",
+      kind: "specialty",
+      memberCount: 2,
+      approvalPolicy: "review",
+    };
+    expect(parseCreativeContexts({ contexts: [context] })).toEqual([
+      expect.objectContaining(context),
+    ]);
+    expect(parseCreativeContexts([context])).toEqual([
+      expect.objectContaining(context),
+    ]);
+  });
+
+  it("normalizes the server membership result without disclosing opaque handles", () => {
+    const memberships = parseContextMemberships({
+      memberships: [
+        {
+          id: "membership-1",
+          contextId: "context-1",
+          artifactKey: "private://provider/opaque-handle",
+          privateMetadata: { token: "secret" },
+          rank: "canonical",
+          status: "active",
+          pendingSubmission: {
+            id: "submission-1",
+            status: "pending",
+            proposedItem: {
+              id: "staged-item",
+              itemVersionId: "staged-version",
+              title: "Proposed deck",
+              kind: "slides-deck",
+              preview: {
+                type: "slides",
+                slides: [{ title: "Preview", cloneHandle: "opaque-handle" }],
+              },
+              privateMetadata: { handle: "secret" },
+            },
+          },
+        },
+      ],
+    });
+    expect(memberships).toEqual([
+      expect.objectContaining({
+        rank: "canonical",
+        status: "active",
+        pendingSubmission: expect.objectContaining({
+          id: "submission-1",
+          status: "pending",
+          proposedItem: expect.objectContaining({ title: "Proposed deck" }),
+        }),
+      }),
+    ]);
+    expect(JSON.stringify(memberships)).not.toMatch(/opaque-handle|secret/);
+  });
+
+  it("filters resource memberships by the generic artifact identity without returning it", () => {
+    const memberships = parseContextMembershipsForResource(
+      {
+        memberships: [
+          {
+            id: "keep",
+            contextId: "context-1",
+            artifactKey: "slides:presentation:deck-1",
+            rank: "normal",
+            status: "active",
+          },
+          {
+            id: "drop",
+            contextId: "context-1",
+            artifactKey: "slides:presentation:deck-2",
+            rank: "normal",
+            status: "active",
+          },
+        ],
+      },
+      { appId: "slides", resourceType: "presentation", resourceId: "deck-1" },
+    );
+    expect(memberships.map((membership) => membership.id)).toEqual(["keep"]);
+    expect(JSON.stringify(memberships)).not.toContain(
+      "slides:presentation:deck-1",
+    );
+  });
+
+  it("keeps only bounded structured safe previews from membership results", () => {
+    const preview = parseCreativeContextSafePreview({
+      type: "slides",
+      slideCount: 2,
+      slides: [
+        {
+          index: 1,
+          title: "Launch overview",
+          excerpt: "A concise first-slide preview.",
+          cloneReference: "private-blob:should-not-cross",
+        },
+      ],
+      privateMetadata: { handle: "opaque" },
+    });
+    expect(preview).toEqual({
+      type: "slides",
+      slideCount: 2,
+      slides: [
+        {
+          index: 1,
+          title: "Launch overview",
+          excerpt: "A concise first-slide preview.",
+        },
+      ],
+    });
+    expect(JSON.stringify(preview)).not.toMatch(/private-blob|opaque/);
+  });
+
+  it("preserves the approved source timestamp used to flag newer app versions", () => {
+    const [membership] = parseContextMemberships({
+      memberships: [
+        {
+          id: "membership-1",
+          contextId: "context-1",
+          publishedItemId: "item-1",
+          publishedItemVersionId: "version-1",
+          publishedItem: {
+            id: "item-1",
+            itemVersionId: "version-1",
+            title: "Launch deck",
+            kind: "slides-deck",
+            sourceModifiedAt: "2026-07-17T12:00:00.000Z",
+          },
+          nativeUpdateStatus: { state: "update-available" },
+        },
+      ],
+    });
+    expect(membership?.publishedItem?.sourceModifiedAt).toBe(
+      "2026-07-17T12:00:00.000Z",
+    );
+    expect(membership?.nativeUpdateStatus).toEqual({
+      state: "update-available",
+    });
+  });
+
+  it("keeps a bounded inert document block model for read-only rendering", () => {
+    const preview = parseCreativeContextSafePreview({
+      type: "document",
+      headings: ["Launch"],
+      excerpt: "A launch plan.",
+      blocks: [
+        { kind: "heading", level: 2, text: "Launch" },
+        { kind: "paragraph", text: "Ship it", html: "<script>bad()</script>" },
+        { kind: "unsupported", text: "Still plain text" },
+      ],
+      html: "<script>bad()</script>",
+    });
+
+    expect(preview).toEqual({
+      type: "document",
+      headings: ["Launch"],
+      excerpt: "A launch plan.",
+      blocks: [
+        { kind: "heading", level: 2, text: "Launch" },
+        { kind: "paragraph", text: "Ship it" },
+        { kind: "paragraph", text: "Still plain text" },
+      ],
+    });
+    expect(JSON.stringify(preview)).not.toContain("script");
+  });
+});