@channel.io/app-sdk-wam 0.18.2 → 0.19.0

package/dist/hooks/index.d.ts

@@ -2,4 +2,5 @@ export * from "./useWamData.js";
 export * from "./useWamSize.js";
 export * from "./useCallFunction.js";
 export * from "./useNativeFunction.js";
+export * from "./useRenderSnapshot.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}

package/dist/hooks/index.js

@@ -2,4 +2,5 @@ export * from "./useWamData.js";
 export * from "./useWamSize.js";
 export * from "./useCallFunction.js";
 export * from "./useNativeFunction.js";
+export * from "./useRenderSnapshot.js";
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}

package/dist/hooks/useRenderSnapshot.d.ts

@@ -0,0 +1,20 @@
+import type { WamRenderData, WamRenderSnapshot } from "@channel.io/app-sdk-core";
+export interface ResolvedRenderSnapshot<T extends WamRenderData = WamRenderData> {
+    wamVersion: number;
+    snapshot: WamRenderSnapshot<T> | (Omit<WamRenderSnapshot<T>, "capturedAt"> & {
+        capturedAt?: undefined;
+    });
+    source: "versioned" | "legacy";
+}
+export interface ResolveRenderSnapshotInput {
+    wamVersion: unknown;
+    renderSnapshot: unknown;
+    publicSnapshot?: unknown;
+}
+export declare function resolveRenderSnapshot<T extends WamRenderData = WamRenderData>({ wamVersion, renderSnapshot, publicSnapshot, }: ResolveRenderSnapshotInput): ResolvedRenderSnapshot<T> | undefined;
+/**
+ * Reads a persisted WAM render snapshot. Legacy CoS clips that only provide
+ * `publicSnapshot` are exposed as renderer/schema version 1.
+ */
+export declare function useRenderSnapshot<T extends WamRenderData = WamRenderData>(): ResolvedRenderSnapshot<T> | undefined;
+//# sourceMappingURL=useRenderSnapshot.d.ts.map

package/dist/hooks/useRenderSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRenderSnapshot.d.ts","sourceRoot":"","sources":["../../src/hooks/useRenderSnapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGjF,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EACN,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACjG,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAcD,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAAE,EAC7E,UAAU,EACV,cAAc,EACd,cAAc,GACf,EAAE,0BAA0B,GAAG,sBAAsB,CAAC,CAAC,CAAC,GAAG,SAAS,CA2BpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,KACvE,sBAAsB,CAAC,CAAC,CAAC,GAAG,SAAS,CActC"}

package/dist/hooks/useRenderSnapshot.js

@@ -0,0 +1,50 @@
+import { useMemo } from "react";
+import { useWamData } from "./useWamData.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPositiveInteger(value) {
+    return Number.isInteger(value) && Number(value) > 0;
+}
+function isCapturedAt(value) {
+    return typeof value === "string" && value.length > 0 && Number.isFinite(Date.parse(value));
+}
+export function resolveRenderSnapshot({ wamVersion, renderSnapshot, publicSnapshot, }) {
+    if (isPositiveInteger(wamVersion) &&
+        isRecord(renderSnapshot) &&
+        isPositiveInteger(renderSnapshot["schemaVersion"]) &&
+        isCapturedAt(renderSnapshot["capturedAt"]) &&
+        isRecord(renderSnapshot["data"])) {
+        return {
+            wamVersion,
+            snapshot: renderSnapshot,
+            source: "versioned",
+        };
+    }
+    if (isRecord(publicSnapshot)) {
+        return {
+            wamVersion: 1,
+            snapshot: {
+                schemaVersion: 1,
+                data: publicSnapshot,
+            },
+            source: "legacy",
+        };
+    }
+    return undefined;
+}
+/**
+ * Reads a persisted WAM render snapshot. Legacy CoS clips that only provide
+ * `publicSnapshot` are exposed as renderer/schema version 1.
+ */
+export function useRenderSnapshot() {
+    const wamVersion = useWamData("wamVersion");
+    const renderSnapshot = useWamData("renderSnapshot");
+    const publicSnapshot = useWamData("publicSnapshot");
+    return useMemo(() => resolveRenderSnapshot({
+        wamVersion,
+        renderSnapshot,
+        publicSnapshot,
+    }), [publicSnapshot, renderSnapshot, wamVersion]);
+}
+//# sourceMappingURL=useRenderSnapshot.js.map

package/dist/hooks/useRenderSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRenderSnapshot.js","sourceRoot":"","sources":["../../src/hooks/useRenderSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAe7C,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,qBAAqB,CAA0C,EAC7E,UAAU,EACV,cAAc,EACd,cAAc,GACa;IAC3B,IACE,iBAAiB,CAAC,UAAU,CAAC;QAC7B,QAAQ,CAAC,cAAc,CAAC;QACxB,iBAAiB,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAClD,YAAY,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAC1C,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChC,CAAC;QACD,OAAO;YACL,UAAU;YACV,QAAQ,EAAE,cAAiD;YAC3D,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE;gBACR,aAAa,EAAE,CAAC;gBAChB,IAAI,EAAE,cAAmB;aAC1B;YACD,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAE/B,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAEpD,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,qBAAqB,CAAI;QACvB,UAAU;QACV,cAAc;QACd,cAAc;KACf,CAAC,EACJ,CAAC,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAC7C,CAAC;AACJ,CAAC"}

package/dist/hooks/useRenderSnapshot.test.d.ts

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

package/dist/hooks/useRenderSnapshot.test.d.ts.map

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

package/dist/hooks/useRenderSnapshot.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import { resolveRenderSnapshot } from "./useRenderSnapshot.js";
+describe("resolveRenderSnapshot", () => {
+    it("resolves a versioned render snapshot", () => {
+        expect(resolveRenderSnapshot({
+            wamVersion: 2,
+            renderSnapshot: {
+                schemaVersion: 3,
+                capturedAt: "2026-08-03T12:00:00.000Z",
+                data: { summary: { title: "Trend" } },
+            },
+        })).toEqual({
+            wamVersion: 2,
+            snapshot: {
+                schemaVersion: 3,
+                capturedAt: "2026-08-03T12:00:00.000Z",
+                data: { summary: { title: "Trend" } },
+            },
+            source: "versioned",
+        });
+    });
+    it("reads a legacy public snapshot as version 1", () => {
+        expect(resolveRenderSnapshot({
+            wamVersion: undefined,
+            renderSnapshot: undefined,
+            publicSnapshot: { rows: [{ rank: 1 }] },
+        })).toMatchObject({
+            wamVersion: 1,
+            snapshot: {
+                schemaVersion: 1,
+                data: { rows: [{ rank: 1 }] },
+            },
+            source: "legacy",
+        });
+    });
+    it("rejects malformed or unsupported envelope values", () => {
+        expect(resolveRenderSnapshot({
+            wamVersion: 0,
+            renderSnapshot: {
+                schemaVersion: 1,
+                capturedAt: "not-a-date",
+                data: [],
+            },
+        })).toBeUndefined();
+    });
+});
+//# sourceMappingURL=useRenderSnapshot.test.js.map

package/dist/hooks/useRenderSnapshot.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRenderSnapshot.test.js","sourceRoot":"","sources":["../../src/hooks/useRenderSnapshot.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CACJ,qBAAqB,CAAC;YACpB,UAAU,EAAE,CAAC;YACb,cAAc,EAAE;gBACd,aAAa,EAAE,CAAC;gBAChB,UAAU,EAAE,0BAA0B;gBACtC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;aACtC;SACF,CAAC,CACH,CAAC,OAAO,CAAC;YACR,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE;gBACR,aAAa,EAAE,CAAC;gBAChB,UAAU,EAAE,0BAA0B;gBACtC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;aACtC;YACD,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CACJ,qBAAqB,CAAC;YACpB,UAAU,EAAE,SAAS;YACrB,cAAc,EAAE,SAAS;YACzB,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE;SACxC,CAAC,CACH,CAAC,aAAa,CAAC;YACd,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE;gBACR,aAAa,EAAE,CAAC;gBAChB,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE;aAC9B;YACD,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CACJ,qBAAqB,CAAC;YACpB,UAAU,EAAE,CAAC;YACb,cAAc,EAAE;gBACd,aAAa,EAAE,CAAC;gBAChB,UAAU,EAAE,YAAY;gBACxB,IAAI,EAAE,EAAE;aACT;SACF,CAAC,CACH,CAAC,aAAa,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@channel.io/app-sdk-wam",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "description": "React SDK for Channel.io WAM (Web App Module)",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,7 +15,9 @@
   "files": [
     "dist"
   ],
-  "dependencies": {},
+  "dependencies": {
+    "@channel.io/app-sdk-core": "0.19.0"
+  },
   "peerDependencies": {
     "react": ">=17.0.0"
   },