@quenty/nevermore-cli 4.39.0 → 4.40.0

package/src/utils/build/deploy-config.ts

@@ -36,6 +36,28 @@ export interface DeployConfig {
   targets: Record<string, DeployTargetConfig>;
 }
 
+/**
+ * The subset of a resolved place that gets baked into the runtime manifest
+ * (see the nevermore-cli-manifest package). A deployed place carries the whole
+ * target's place table so it can resolve its siblings' IDs at runtime — e.g. a
+ * chapter place teleporting to another chapter without hard-coding place IDs.
+ */
+export interface ManifestPlaceInfo {
+  /** Place name from a multi-place target (e.g. "chapter0"); absent for single-place targets. */
+  name?: string;
+  placeId: number;
+  universeId: number;
+}
+
+/** Project a resolved deploy place down to the fields stamped into the manifest. */
+export function toManifestPlaceInfo(place: DeployTarget): ManifestPlaceInfo {
+  return {
+    name: place.name,
+    placeId: place.placeId,
+    universeId: place.universeId,
+  };
+}
+
 function _isMultiPlace(
   target: DeployTargetConfig
 ): target is MultiPlaceTargetConfig {

package/src/utils/deploy/deploy-metadata.test.ts

@@ -84,6 +84,34 @@ describe('buildDeployMetadataAttributes', () => {
     );
     expect(attributes.Published).toBe(false);
   });
+
+  it('omits Places when no place table is given', () => {
+    const attributes = buildDeployMetadataAttributes({}, PLACE);
+    expect('Places' in attributes).toBe(false);
+  });
+
+  it('stamps Places as a JSON string preserving large IDs exactly', () => {
+    const attributes = buildDeployMetadataAttributes({}, PLACE, [
+      { name: 'chapter0', placeId: 97235312452456, universeId: 10192566764 },
+      { name: 'chapter1', placeId: 87639818897831, universeId: 10192566764 },
+    ]);
+    expect(typeof attributes.Places).toBe('string');
+    const parsed = JSON.parse(attributes.Places as string);
+    // Large place IDs must survive exactly (JSON text, not a float32 attribute).
+    expect(parsed).toEqual([
+      { name: 'chapter0', placeId: 97235312452456, universeId: 10192566764 },
+      { name: 'chapter1', placeId: 87639818897831, universeId: 10192566764 },
+    ]);
+  });
+
+  it('omits the name key for a single-place (nameless) target', () => {
+    const attributes = buildDeployMetadataAttributes({}, PLACE, [
+      { placeId: 123, universeId: 456 },
+    ]);
+    const parsed = JSON.parse(attributes.Places as string);
+    expect(parsed).toEqual([{ placeId: 123, universeId: 456 }]);
+    expect('name' in parsed[0]).toBe(false);
+  });
 });
 
 describe('packageUsesManifestAsync', () => {

package/src/utils/deploy/deploy-metadata.ts

@@ -7,6 +7,7 @@ import {
 } from '@quenty/nevermore-template-helpers';
 import { OutputHelper } from '@quenty/cli-output-helpers';
 import { type BuiltPlace } from '../build/build.js';
+import { type ManifestPlaceInfo } from '../build/deploy-config.js';
 
 /** npm name of the package that ships the manifest module. */
 export const MANIFEST_PACKAGE_NAME = '@quenty/nevermoreclimanifest';
@@ -85,10 +86,16 @@ export interface DeployPlaceInfo {
  * round-trip through Lune serialization as float32, which silently corrupts IDs
  * above 2^24 (e.g. 123456789 -> 123456792). Strings are exact; the Luau reader
  * converts them back with `tonumber`.
+ *
+ * When `places` is given (the whole target's place table), it is stamped as a
+ * `Places` JSON-string attribute. The IDs inside stay numeric — a JSON string
+ * is exact text, and the Luau reader decodes it to 64-bit numbers, so the
+ * float32 hazard that forces the top-level IDs to be stringified doesn't apply.
  */
 export function buildDeployMetadataAttributes(
   git: GitDeployInfo,
-  place: DeployPlaceInfo
+  place: DeployPlaceInfo,
+  places?: readonly ManifestPlaceInfo[]
 ): DeployMetadataAttributes {
   const attributes: DeployMetadataAttributes = {
     Deployed: true,
@@ -101,6 +108,15 @@ export function buildDeployMetadataAttributes(
   if (git.commit) attributes.Commit = git.commit;
   if (git.version) attributes.Version = git.version;
   if (git.branch) attributes.Branch = git.branch;
+  if (places && places.length > 0) {
+    attributes.Places = JSON.stringify(
+      places.map((p) => ({
+        name: p.name,
+        placeId: p.placeId,
+        universeId: p.universeId,
+      }))
+    );
+  }
   return attributes;
 }