@spacefast/common 0.2.2 → 0.4.1

package/dist/contracts/fixtures/content-platform-v1.json

@@ -60,10 +60,10 @@
         }
     },
     "artifacts": {
-        "program": {
+        "model": {
             "format": "spacefast.zero-wordpress",
             "version": 1,
-            "revision": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
+            "revision": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
             "schemas": [
                 {
                     "id": "empty-object",
@@ -150,7 +150,7 @@
                 }
             ],
             "wordpress": {
-                "format": "spacefast.wordpress-program",
+                "format": "spacefast.wordpress-content-model",
                 "version": 1,
                 "resources": [
                     {
@@ -401,7 +401,7 @@
                         "sha256": "sha256:8519907eb445b35dad6b18a21b1d6bf4b0f91e9c3bad95c2c21ec59923952ae1"
                     },
                     "permits": ["page.view"],
-                    "reads": ["content.projects"],
+                    "reads": ["content.projects", "table.reactions"],
                     "writes": [],
                     "exposure": {
                         "kind": "named",
@@ -443,14 +443,35 @@
                     "resourceId": "projects",
                     "fieldId": "project-body",
                     "source": "content/projects/launch.md",
+                    "format": "md",
                     "slug": "launch"
+                },
+                {
+                    "id": "sync.projects-guide",
+                    "resourceId": "projects",
+                    "fieldId": "project-body",
+                    "source": "content/projects/guide.tsx",
+                    "format": "tsx",
+                    "compiled": {
+                        "sha256": "sha256:5cd63a374f48166002badd36823204db55a55ce5c69ffa3c703e36b9e1662ac8"
+                    },
+                    "slug": "guide"
+                }
+            ],
+            "materializations": [
+                {
+                    "resourceId": "projects",
+                    "fieldId": "project-body",
+                    "directory": "content/projects",
+                    "suffix": ".md",
+                    "format": "md"
                 }
             ]
         },
         "executables": {
             "format": "spacefast.zero-executables",
             "version": 1,
-            "inputDigest": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
+            "inputDigest": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
             "executables": [
                 {
                     "id": "content.projects.list",
@@ -493,7 +514,7 @@
         "sdk": {
             "format": "spacefast.sdk-descriptors",
             "version": 1,
-            "inputDigest": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
+            "inputDigest": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
             "operations": [
                 {
                     "id": "content.projects.list",
@@ -548,7 +569,7 @@
                     "cache": {
                         "kind": "none"
                     },
-                    "invalidates": []
+                    "invalidates": ["endpoint.preview"]
                 },
                 {
                     "id": "endpoint.webhook",
@@ -565,7 +586,7 @@
                     "cache": {
                         "kind": "none"
                     },
-                    "invalidates": []
+                    "invalidates": ["endpoint.preview"]
                 },
                 {
                     "id": "endpoint.preview",
@@ -591,13 +612,18 @@
                     "id": "sync.projects-body",
                     "resourceId": "projects",
                     "source": "content/projects/launch.md"
+                },
+                {
+                    "id": "sync.projects-guide",
+                    "resourceId": "projects",
+                    "source": "content/projects/guide.tsx"
                 }
             ]
         },
         "routes": {
             "format": "spacefast.route-contributions",
             "version": 1,
-            "inputDigest": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
+            "inputDigest": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
             "routes": [
                 {
                     "abilityId": "endpoint.webhook",
@@ -611,9 +637,9 @@
             ]
         },
         "requirements": {
-            "format": "spacefast.program-requirements",
+            "format": "spacefast.content-model-requirements",
             "version": 1,
-            "inputDigest": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
+            "inputDigest": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
             "wordpressAbi": 1,
             "capabilities": [
                 "wordpress.content",
@@ -623,52 +649,52 @@
                 "wordpress.typed-meta",
                 "lakebed.tables",
                 "application.journal",
-                "markdown.sync",
+                "source.sync",
                 "quickjs.v1"
             ]
         }
     },
     "compiled": {
-        "format": "spacefast.compiled-program",
+        "format": "spacefast.compiled-content-model",
         "version": 1,
-        "program": {
+        "model": {
             "format": "spacefast.zero-wordpress",
             "version": 1,
             "inputDigest": "sha256:453c1f28a31bbe19a7bb923d221ab1a16c804ca98c485c1f80981cb39b3b789b",
-            "sha256": "sha256:3dbc9207178f4886b12914a6fb581f35b40f7bd333e7ba1c8fbbdc92d1b4fd7f",
-            "bytes": 6114,
+            "sha256": "sha256:74a3dbfedf29257c569651f2b43588a4eab30f97c67731a6965bd73ea7c68dbf",
+            "bytes": 6526,
             "mediaType": "application/json"
         },
         "executables": {
             "format": "spacefast.zero-executables",
             "version": 1,
-            "inputDigest": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
-            "sha256": "sha256:952d34a3f0f78c780de12216835640d1964cdc5a3be03668006f6be6e9d88c49",
+            "inputDigest": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
+            "sha256": "sha256:c9f63e4135bda1befe79a66c7c8b6ae12248ab2d3f8d5f694060001ec1f13a2f",
             "bytes": 1132,
             "mediaType": "application/json"
         },
         "sdk": {
             "format": "spacefast.sdk-descriptors",
             "version": 1,
-            "inputDigest": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
-            "sha256": "sha256:35df0ef9700e718c3039a8174c32e79bd651e563ad06a542308543d768493d11",
-            "bytes": 2068,
+            "inputDigest": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
+            "sha256": "sha256:cc616c540fbe32b918740254646ac543b4611f3343f1c8684c48366276e92664",
+            "bytes": 2195,
             "mediaType": "application/json"
         },
         "routes": {
             "format": "spacefast.route-contributions",
             "version": 1,
-            "inputDigest": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
-            "sha256": "sha256:8dcb83db26af38985f09eb1a1ccc82d2c5c34dc3dcc5fb56eb8b152b54a4153b",
+            "inputDigest": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
+            "sha256": "sha256:9ecec869bec2ef52e1942599cc79ea3ec8df47bcc4852eb0a72d550f8f854169",
             "bytes": 285,
             "mediaType": "application/json"
         },
         "requirements": {
-            "format": "spacefast.program-requirements",
+            "format": "spacefast.content-model-requirements",
             "version": 1,
-            "inputDigest": "sha256:f4727c476bcd1793f2fd8cdb232d8705a65eef10d35f6736bb2503bfe0e89e5f",
-            "sha256": "sha256:eda721f19fac69de9d964a64f5d16840e3043e2210f525d0225f0f949eb9d53d",
-            "bytes": 347,
+            "inputDigest": "sha256:5d447339ad5645d9c7473c8679a711d8bffb53053bc3875a2183a13765be772a",
+            "sha256": "sha256:4b8a3c552ab82921be8b4b83dab220c4e93799cccc127fc22cac0530e051f709",
+            "bytes": 351,
             "mediaType": "application/json"
         }
     },
@@ -676,7 +702,7 @@
         "format": "spacefast.wordpress-components",
         "version": 1,
         "platformRelease": "2026.08.28.1",
-        "digest": "sha256:f7dfb8ce89b763198efe31f2ec4b908208316d2669ecc850bd092f2c4f63e09d",
+        "digest": "sha256:6ebad0f65434427fa6a65a0d60f43b47807af2f967aa125bfa9cf76ec8fed998",
         "components": [
             {
                 "id": "wordpress-core",
@@ -712,7 +738,7 @@
                     "kind": "embedded",
                     "path": "wordpress/content-kernel.php"
                 },
-                "provides": ["application.journal", "markdown.sync", "lakebed.tables"],
+                "provides": ["application.journal", "source.sync", "lakebed.tables"],
                 "activation": "always"
             },
             {
@@ -774,9 +800,33 @@
                     "kind": "embedded",
                     "path": "wordpress/block-transformer.zip"
                 },
-                "provides": ["wordpress.blocks", "markdown.sync"],
+                "provides": ["wordpress.blocks", "source.sync"],
+                "activation": "always"
+            },
+            {
+                "id": "php-toolkit",
+                "kind": "runtime-library",
+                "version": "0.9.0",
+                "sha256": "sha256:bd452b61fd6ee9f4838ff416a3d225e6c82a742ffaf325a57ad327828eda446a",
+                "source": {
+                    "kind": "embedded",
+                    "path": "engine/vendor/php-toolkit.phar"
+                },
+                "provides": ["wordpress.markdown"],
                 "activation": "always"
             },
+            {
+                "id": "jetpack",
+                "kind": "plugin",
+                "version": "latest",
+                "sha256": "sha256:55ee45c302c9090e2be6fe18ce2f604d236355bec5d139548d9d32ede035953c",
+                "source": {
+                    "kind": "provider-managed",
+                    "software": "plugins/jetpack/latest"
+                },
+                "provides": ["wordpress.jetpack"],
+                "activation": "on-demand"
+            },
             {
                 "id": "quickjs-abi",
                 "kind": "quickjs-abi",
@@ -801,9 +851,9 @@
             "siteId": "site-fixture"
         },
         "platformRelease": "2026.08.28.1",
-        "expectedInventoryDigest": "sha256:f7dfb8ce89b763198efe31f2ec4b908208316d2669ecc850bd092f2c4f63e09d",
+        "expectedInventoryDigest": "sha256:6ebad0f65434427fa6a65a0d60f43b47807af2f967aa125bfa9cf76ec8fed998",
         "status": "ready",
-        "observedInventoryDigest": "sha256:f7dfb8ce89b763198efe31f2ec4b908208316d2669ecc850bd092f2c4f63e09d",
+        "observedInventoryDigest": "sha256:6ebad0f65434427fa6a65a0d60f43b47807af2f967aa125bfa9cf76ec8fed998",
         "substrate": {
             "wordpress": {
                 "boot": "ready",
@@ -820,7 +870,8 @@
             },
             "journal": {
                 "state": "ready"
-            }
+            },
+            "onDemandActive": ["jetpack"]
         }
     },
     "routeInventory": {
@@ -894,6 +945,7 @@
             "nonce": "principal-fixture-nonce",
             "issuedAt": 1787923200,
             "expiresAt": 1787923500,
+            "wordpressRole": "editor",
             "actor": {
                 "kind": "user",
                 "id": "usr_fixture"
@@ -974,26 +1026,27 @@
             "request": {
                 "bindingId": "sync.projects-body",
                 "source": "content/projects/launch.md",
-                "markdown": "# Launch\n\nThe launch project is ready.\n",
+                "text": "# Launch\n\nThe launch project is ready.\n",
                 "observedSourceRevision": "git-fixture-abc",
                 "operationId": "op_syncfixture",
                 "state": "bound",
                 "baseRevision": "sha256:c2bd36ab817475221782deac9e068597bfea910284098657326da7bc511d699c"
             },
             "receipt": {
-                "format": "spacefast.markdown-sync",
+                "format": "spacefast.content-sync",
                 "version": 1,
                 "operationId": "op_syncfixture",
                 "ledger": {
                     "version": 1,
                     "bindingId": "sync.projects-body",
                     "source": "content/projects/launch.md",
-                    "baseMarkdown": "# Launch\n\nThe launch project is ready.\n",
-                    "markdownDigest": "sha256:446c2cc77e227e78a0fab20e055fa95b1d43f65bb729144ecd0192b6500d0363",
+                    "format": "md",
+                    "baseText": "# Launch\n\nThe launch project is ready.\n",
+                    "textDigest": "sha256:446c2cc77e227e78a0fab20e055fa95b1d43f65bb729144ecd0192b6500d0363",
                     "blocksDigest": "sha256:4238420e9cd3767bfb446219efd5ff43629d0d8e4d9a4fbd29caac22dfa8e16e",
                     "wordpressRevisionId": 42,
                     "serializerVersion": 1,
-                    "revision": "sha256:8b2067b270a7ae09423a5126aeec05686ae2f1226e8b679fb53ffd06a043ff3c",
+                    "revision": "sha256:f9be9d2dff4e904b58d7023984c8a7e0c4362fb3ac0316271c5fd31550347e31",
                     "lastDirection": "pull"
                 },
                 "status": "pulled",
@@ -1001,39 +1054,38 @@
                     "state": "prepared",
                     "source": "content/projects/launch.md",
                     "expectedSourceRevision": "git-fixture-abc",
-                    "markdown": "# Launch\n\nThe launch project is ready.\n",
-                    "markdownDigest": "sha256:446c2cc77e227e78a0fab20e055fa95b1d43f65bb729144ecd0192b6500d0363"
+                    "text": "# Launch\n\nThe launch project is ready.\n",
+                    "textDigest": "sha256:446c2cc77e227e78a0fab20e055fa95b1d43f65bb729144ecd0192b6500d0363"
                 }
             }
         },
         "syncSourceAcknowledgement": {
-            "format": "spacefast.markdown-sync-ack",
+            "format": "spacefast.content-sync-ack",
             "version": 1,
             "bindingId": "sync.projects-body",
             "operationId": "op_syncfixture",
-            "sourceRevision": "git-fixture-def",
-            "baseRevision": "sha256:8b2067b270a7ae09423a5126aeec05686ae2f1226e8b679fb53ffd06a043ff3c"
+            "baseRevision": "sha256:f9be9d2dff4e904b58d7023984c8a7e0c4362fb3ac0316271c5fd31550347e31"
         },
         "syncConflict": {
-            "type": "https://spacefast.com/problems/content_markdown_conflict",
-            "title": "Markdown changed on both sides",
+            "type": "https://spacefast.com/problems/content_sync_conflict",
+            "title": "The source changed on both sides",
             "status": 409,
             "detail": "The source and WordPress document both changed after the common base.",
-            "code": "content_markdown_conflict",
+            "code": "content_sync_conflict",
             "details": {
                 "bindingId": "sync.projects-body",
                 "base": {
-                    "markdown": "# Launch\n",
+                    "text": "# Launch\n",
                     "digest": "sha256:fbc640ee8eab5d0c68f5715a484b9747b2359a5ce135ab15e7831339c8bff84d",
                     "revision": "base-40"
                 },
                 "source": {
-                    "markdown": "# Launch source\n",
+                    "text": "# Launch source\n",
                     "digest": "sha256:d930a247da873f3f46eea3af7b1d8dbb43d677c9a233a62b2b5fe43a23ffc38c",
                     "revision": "git-abc"
                 },
                 "wordpress": {
-                    "markdown": "# Launch editor\n",
+                    "text": "# Launch editor\n",
                     "digest": "sha256:7d2a535a8e3c29ffd0b50d4be7804f12bc86be29f0406c01e351454914c73b90",
                     "revision": "wp-43",
                     "wordpressRevisionId": 43

package/dist/contracts/frame-session.d.ts

@@ -2,7 +2,7 @@ import { z } from "zod";
 export declare const frameTargetV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"live">;
     versionId: z.ZodTemplateLiteral<`ver_${string}`>;
-    routeRevision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    routeRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"version">;
     versionId: z.ZodTemplateLiteral<`ver_${string}`>;
@@ -10,7 +10,7 @@ export declare const frameTargetV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"branch">;
     branch: z.ZodString;
     versionId: z.ZodTemplateLiteral<`ver_${string}`>;
-    branchRevision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    branchRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
 }, z.core.$strict>], "kind">;
 export type FrameTargetV1 = z.infer<typeof frameTargetV1Schema>;
 export declare const framePrincipalV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -54,7 +54,7 @@ export declare const frameGrantDecisionV1Schema: z.ZodObject<{
     target: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"live">;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
-        routeRevision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        routeRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"version">;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
@@ -62,7 +62,7 @@ export declare const frameGrantDecisionV1Schema: z.ZodObject<{
         kind: z.ZodLiteral<"branch">;
         branch: z.ZodString;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
-        branchRevision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        branchRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>], "kind">;
     surface: z.ZodEnum<{
         "wordpress.editor": "wordpress.editor";
@@ -108,7 +108,7 @@ export declare const frameLaunchTicketClaimsV1Schema: z.ZodObject<{
     target: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"live">;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
-        routeRevision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        routeRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"version">;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
@@ -116,7 +116,7 @@ export declare const frameLaunchTicketClaimsV1Schema: z.ZodObject<{
         kind: z.ZodLiteral<"branch">;
         branch: z.ZodString;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
-        branchRevision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        branchRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>], "kind">;
     surface: z.ZodEnum<{
         "wordpress.editor": "wordpress.editor";
@@ -130,7 +130,7 @@ export declare const frameLaunchTicketClaimsV1Schema: z.ZodObject<{
         "content.publish": "content.publish";
         "access.manage": "access.manage";
     }>>;
-    grantDecisionDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    grantDecisionDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     accessGeneration: z.ZodNumber;
     sessionVersion: z.ZodNumber;
     issuedAt: z.ZodNumber;
@@ -160,7 +160,7 @@ export declare const frameSessionClaimsV1Schema: z.ZodObject<{
     target: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"live">;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
-        routeRevision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        routeRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"version">;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
@@ -168,7 +168,7 @@ export declare const frameSessionClaimsV1Schema: z.ZodObject<{
         kind: z.ZodLiteral<"branch">;
         branch: z.ZodString;
         versionId: z.ZodTemplateLiteral<`ver_${string}`>;
-        branchRevision: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+        branchRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     }, z.core.$strict>], "kind">;
     surface: z.ZodEnum<{
         "wordpress.editor": "wordpress.editor";
@@ -182,7 +182,7 @@ export declare const frameSessionClaimsV1Schema: z.ZodObject<{
         "content.publish": "content.publish";
         "access.manage": "access.manage";
     }>>;
-    grantDecisionDigest: z.core.$ZodBranded<z.ZodString, "ContentProgramSha256", "out">;
+    grantDecisionDigest: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
     accessGeneration: z.ZodNumber;
     sessionVersion: z.ZodNumber;
     nonce: z.ZodString;
@@ -190,3 +190,53 @@ export declare const frameSessionClaimsV1Schema: z.ZodObject<{
     expiresAt: z.ZodNumber;
 }, z.core.$strict>;
 export type FrameSessionClaimsV1 = z.infer<typeof frameSessionClaimsV1Schema>;
+export declare const SPACEFAST_FRAME_LAUNCH_TICKET_TTL_SECONDS = 60;
+export declare const SPACEFAST_FRAME_SESSION_TTL_SECONDS: number;
+export declare const spacefastFrameSessionLaunchSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"version">;
+        versionId: z.ZodTemplateLiteral<`ver_${string}`>;
+    }, z.core.$strict>>;
+    surface: z.ZodDefault<z.ZodEnum<{
+        "wordpress.editor": "wordpress.editor";
+        "wordpress.preview": "wordpress.preview";
+    }>>;
+}, z.core.$strict>;
+export declare const spacefastFrameSessionRenewSchema: z.ZodObject<{
+    sessionToken: z.ZodString;
+}, z.core.$strict>;
+export declare const spacefastFrameSessionSchema: z.ZodObject<{
+    spaceId: z.ZodTemplateLiteral<`spc_${string}`>;
+    linkId: z.ZodTemplateLiteral<`lnk_${string}`>;
+    linkRevision: z.ZodNumber;
+    parentOrigin: z.core.$ZodBranded<z.ZodString, "ExactOrigin", "out">;
+    path: z.ZodString;
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"live">;
+        versionId: z.ZodTemplateLiteral<`ver_${string}`>;
+        routeRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"version">;
+        versionId: z.ZodTemplateLiteral<`ver_${string}`>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"branch">;
+        branch: z.ZodString;
+        versionId: z.ZodTemplateLiteral<`ver_${string}`>;
+        branchRevision: z.core.$ZodBranded<z.ZodString, "ContentModelSha256", "out">;
+    }, z.core.$strict>], "kind">;
+    surface: z.ZodEnum<{
+        "wordpress.editor": "wordpress.editor";
+        "wordpress.preview": "wordpress.preview";
+    }>;
+    access: z.ZodEnum<{
+        private: "private";
+        public: "public";
+    }>;
+    url: z.ZodString;
+    sessionToken: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strict>;
+export type SpacefastFrameSessionLaunch = z.infer<typeof spacefastFrameSessionLaunchSchema>;
+export type SpacefastFrameSessionRenew = z.infer<typeof spacefastFrameSessionRenewSchema>;
+export type SpacefastFrameSession = z.infer<typeof spacefastFrameSessionSchema>;

package/dist/contracts/frame-session.js

@@ -1,23 +1,27 @@
 import { z } from "zod";
-import { contentProgramSha256Schema } from "./content-program.js";
-import { grantCapabilitySchema } from "./grants.js";
-import { registeredIdSchema } from "./ids.js";
+import { accessScopePathSchema } from "./access-core.js";
+import { contentModelSha256Schema } from "./content-model.js";
+import { grantCapabilitySchema } from "./grants-core.js";
+// Frame tickets travel between the dashboard, the control plane and the serving
+// runtime, so the prefixed ids below are this contract's wire format rather than
+// a read of the host's prefix registry.
+import { prefixedIdSchema } from "./ids-core.js";
 import { exactOriginSchema } from "./principal-assertion.js";
 export const frameTargetV1Schema = z.discriminatedUnion("kind", [
     z
         .object({
         kind: z.literal("live"),
-        versionId: registeredIdSchema("ver"),
-        routeRevision: contentProgramSha256Schema,
+        versionId: prefixedIdSchema("ver", "Version"),
+        routeRevision: contentModelSha256Schema,
     })
         .strict(),
-    z.object({ kind: z.literal("version"), versionId: registeredIdSchema("ver") }).strict(),
+    z.object({ kind: z.literal("version"), versionId: prefixedIdSchema("ver", "Version") }).strict(),
     z
         .object({
         kind: z.literal("branch"),
         branch: z.string().min(1).max(255),
-        versionId: registeredIdSchema("ver"),
-        branchRevision: contentProgramSha256Schema,
+        versionId: prefixedIdSchema("ver", "Version"),
+        branchRevision: contentModelSha256Schema,
     })
         .strict(),
 ]);
@@ -33,7 +37,7 @@ export const framePrincipalV1Schema = z.discriminatedUnion("kind", [
 ]);
 export const frameAudienceV1Schema = z
     .object({
-    spaceId: registeredIdSchema("spc"),
+    spaceId: prefixedIdSchema("spc", "Space"),
     runtimeInstanceId: z.string().min(1).max(255),
     host: exactOriginSchema,
 })
@@ -44,7 +48,7 @@ export const frameAudienceV1Schema = z
 // projection without translating a second revision scheme.
 export const frameLinkRevisionV1Schema = z
     .object({
-    id: registeredIdSchema("lnk"),
+    id: prefixedIdSchema("lnk", "ShareLink"),
     revision: z.number().int().positive(),
 })
     .strict();
@@ -108,7 +112,7 @@ export const frameLaunchTicketClaimsV1Schema = z
     surface: z.enum(["wordpress.editor", "wordpress.preview"]),
     parentOrigin: exactOriginSchema,
     capabilities: z.array(grantCapabilitySchema).min(1).max(5),
-    grantDecisionDigest: contentProgramSha256Schema,
+    grantDecisionDigest: contentModelSha256Schema,
     accessGeneration: z.number().int().nonnegative(),
     sessionVersion: z.number().int().nonnegative(),
     issuedAt: z.number().int().nonnegative(),
@@ -137,7 +141,7 @@ export const frameSessionClaimsV1Schema = z
     surface: z.enum(["wordpress.editor", "wordpress.preview"]),
     parentOrigin: exactOriginSchema,
     capabilities: z.array(grantCapabilitySchema).min(1).max(5),
-    grantDecisionDigest: contentProgramSha256Schema,
+    grantDecisionDigest: contentModelSha256Schema,
     accessGeneration: z.number().int().nonnegative(),
     sessionVersion: z.number().int().nonnegative(),
     nonce: z.string().min(16).max(512),
@@ -162,3 +166,39 @@ export const frameSessionClaimsV1Schema = z
     }
     validateFrameAuthority(claims, context, "Frame sessions");
 });
+export const SPACEFAST_FRAME_LAUNCH_TICKET_TTL_SECONDS = 60;
+// A Frame session never outlives the principal assertion it was cut from, and
+// an assertion may live at most five minutes (principal-assertion.ts). The
+// renewal route re-evaluates the Link and re-cuts both, so this is the window
+// between authority checks, not the life of the frame.
+export const SPACEFAST_FRAME_SESSION_TTL_SECONDS = 5 * 60;
+const requestedFrameVersionTargetV1Schema = z
+    .object({ kind: z.literal("version"), versionId: prefixedIdSchema("ver", "Version") })
+    .strict();
+export const spacefastFrameSessionLaunchSchema = z
+    .object({
+    path: accessScopePathSchema.optional(),
+    target: requestedFrameVersionTargetV1Schema
+        .optional()
+        .describe("The immutable Version to launch when the Link targets all Versions."),
+    surface: z.enum(["wordpress.editor", "wordpress.preview"]).default("wordpress.preview"),
+})
+    .strict();
+export const spacefastFrameSessionRenewSchema = z
+    .object({ sessionToken: z.string().min(32).max(16_384) })
+    .strict();
+export const spacefastFrameSessionSchema = z
+    .object({
+    spaceId: prefixedIdSchema("spc", "Space"),
+    linkId: prefixedIdSchema("lnk", "ShareLink"),
+    linkRevision: z.number().int().positive(),
+    parentOrigin: exactOriginSchema,
+    path: accessScopePathSchema,
+    target: frameTargetV1Schema,
+    surface: z.enum(["wordpress.editor", "wordpress.preview"]),
+    access: z.enum(["public", "private"]),
+    url: z.string().url(),
+    sessionToken: z.string().min(32),
+    expiresAt: z.string().datetime(),
+})
+    .strict();