@expofp/config 3.29.0 → 3.30.0

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { parseDeprecatedUrlParams } from './lib/deprecated-url-params.js';
 export { type LegacyOneShot, type LegacyPrimary, type LegacyUrlQuery, parseLegacyQuery, serializeSelection, splitPlatformParams, type UrlSelection, } from './lib/legacy-url.js';
 export { loadConfig } from './lib/load-config.js';
 export { type StorageLike } from './lib/local-storage-codec.js';
-export { type ConfigResourceStore, serializeConfigResources, } from './lib/serialize-config-resources.js';
+export { type ConfigResourceStore, serializationFormat, serializeConfigResources, SERIALIZER_VERSION, } from './lib/serialize-config-resources.js';
 export { compactUrl, resolveUrl } from './lib/store-ref.js';
 export { parseFromUrlTolerant } from './lib/url-codec.js';
 export { parseIntentsFromUrl } from './lib/url-intents.js';

package/dist/index.js

@@ -6,7 +6,7 @@ export { toDebugSettings } from './lib/debug-settings.js';
 export { parseDeprecatedUrlParams } from './lib/deprecated-url-params.js';
 export { parseLegacyQuery, serializeSelection, splitPlatformParams, } from './lib/legacy-url.js';
 export { loadConfig } from './lib/load-config.js';
-export { serializeConfigResources, } from './lib/serialize-config-resources.js';
+export { serializationFormat, serializeConfigResources, SERIALIZER_VERSION, } from './lib/serialize-config-resources.js';
 export { compactUrl, resolveUrl } from './lib/store-ref.js';
 export { parseFromUrlTolerant } from './lib/url-codec.js';
 export { parseIntentsFromUrl } from './lib/url-intents.js';

package/dist/lib/serialize-config-resources.d.ts

@@ -19,4 +19,28 @@ export type ConfigResourceStore = ResourceHandler;
 export declare function serializeConfigResources(config: Config, store: ConfigResourceStore, options?: {
     signal?: AbortSignal | null;
 }): Promise<Manifest>;
+/**
+ * Version of the serialization POLICY — what {@link serializeConfigResources}
+ * does to a config beyond what the schema says: the walk's rewrite rules
+ * (`visit-resources`), the CSS `@import` splicing, the legacy normalization.
+ * Bump it by hand when that behavior changes without a schema change; it is
+ * one half of {@link serializationFormat}.
+ */
+export declare const SERIALIZER_VERSION = 1;
+/**
+ * The identity of the form a serialized manifest takes — the text a generator
+ * hashes into its format stamp. Two halves: the JSON Schema of `ConfigSchema`
+ * (the shape every snapshot follows; the referenced document schemas ride
+ * inside it, so a drawing- or wayfinding-schema change counts too — a schema
+ * change is a format change by construction, no hand bump needed) and
+ * {@link SERIALIZER_VERSION}. Deterministic across processes and platforms
+ * for one build of the packages.
+ *
+ * A snapshot built under one stamp must not be served under a runtime that
+ * expects another: the cloud generator (plan G § 2, wave G2) keys its
+ * level-0 "nothing changed" skip on this stamp next to the data revision, so
+ * a deploy that changes the format rebuilds every snapshot and a deploy that
+ * does not leaves them alone.
+ */
+export declare function serializationFormat(): string;
 //# sourceMappingURL=serialize-config-resources.d.ts.map

package/dist/lib/serialize-config-resources.js

@@ -1,4 +1,5 @@
 import { ConfigSchema } from '@expofp/schema';
+import * as z from 'zod';
 import { visitResources } from './visit-resources.js';
 /**
  * Serialize a loaded config into a portable manifest: every schema-tagged
@@ -18,3 +19,32 @@ export async function serializeConfigResources(config, store, options) {
     await visitResources(ConfigSchema, manifest, store, { signal: options?.signal });
     return manifest;
 }
+/**
+ * Version of the serialization POLICY — what {@link serializeConfigResources}
+ * does to a config beyond what the schema says: the walk's rewrite rules
+ * (`visit-resources`), the CSS `@import` splicing, the legacy normalization.
+ * Bump it by hand when that behavior changes without a schema change; it is
+ * one half of {@link serializationFormat}.
+ */
+export const SERIALIZER_VERSION = 1;
+/**
+ * The identity of the form a serialized manifest takes — the text a generator
+ * hashes into its format stamp. Two halves: the JSON Schema of `ConfigSchema`
+ * (the shape every snapshot follows; the referenced document schemas ride
+ * inside it, so a drawing- or wayfinding-schema change counts too — a schema
+ * change is a format change by construction, no hand bump needed) and
+ * {@link SERIALIZER_VERSION}. Deterministic across processes and platforms
+ * for one build of the packages.
+ *
+ * A snapshot built under one stamp must not be served under a runtime that
+ * expects another: the cloud generator (plan G § 2, wave G2) keys its
+ * level-0 "nothing changed" skip on this stamp next to the data revision, so
+ * a deploy that changes the format rebuilds every snapshot and a deploy that
+ * does not leaves them alone.
+ */
+export function serializationFormat() {
+    return JSON.stringify({
+        serializer: SERIALIZER_VERSION,
+        schema: z.toJSONSchema(ConfigSchema, { io: 'input' }),
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expofp/config",
-  "version": "3.29.0",
+  "version": "3.30.0",
   "type": "module",
   "description": "ExpoFP SDK internal: config layer and schemas",
   "homepage": "https://developer.expofp.com/",
@@ -29,8 +29,8 @@
     "debug": "^4.4.3",
     "tslib": "^2.3.0",
     "zod": "4.4.3",
-    "@expofp/resolve": "3.29.0",
-    "@expofp/schema": "3.29.0",
-    "@expofp/utils": "3.29.0"
+    "@expofp/resolve": "3.30.0",
+    "@expofp/schema": "3.30.0",
+    "@expofp/utils": "3.30.0"
   }
 }