@flighthq/entity 0.5.1-next.815.cc08b93 → 0.5.1-next.903.f434bc2

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/entity`. The `@fligh
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/entity@0.5.1-next.815.cc08b93](https://github.com/flighthq/flight/tree/cc08b93ef981080fa86bdd5143dc61dbdbf2665b/packages/entity)
-- [License](https://github.com/flighthq/flight/blob/cc08b93ef981080fa86bdd5143dc61dbdbf2665b/LICENSE.md)
+- [Source for @flighthq/entity@0.5.1-next.903.f434bc2](https://github.com/flighthq/flight/tree/f434bc233778d75aeea61995df3a8cfaec459a85/packages/entity)
+- [License](https://github.com/flighthq/flight/blob/f434bc233778d75aeea61995df3a8cfaec459a85/LICENSE.md)

package/dist/clone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAQ7E,wBAAgB,WAAW,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAI7E;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAI1G"}
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAM7E,wBAAgB,WAAW,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAI7E;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAI1G"}

package/dist/clone.js

@@ -1,12 +1,11 @@
 import { EntityRuntimeKey } from '@flighthq/types/contract';
-import { createEntity } from './entity';
 // Allocates a new entity by copying the public data fields of the source, with the runtime
 // slot reset to undefined. The clone is a fresh, unbound entity — runtime and binding are
 // intentionally not carried over.
 export function cloneEntity(source) {
     const copy = { ...source };
     copy[EntityRuntimeKey] = undefined;
-    return createEntity(copy);
+    return copy;
 }
 // Returns a plain object with the EntityRuntimeKey slot removed, ready to pass to a
 // serializer or JSON.stringify. The runtime is explicitly non-serializable; this helper

package/dist/clone.js.map

@@ -1 +1 @@
-{"version":3,"file":"clone.js","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,2FAA2F;AAC3F,0FAA0F;AAC1F,kCAAkC;AAClC,MAAM,UAAU,WAAW,CAAsB,MAAsB;IACrE,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAkC,CAAC;IAC3D,IAAI,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACnC,OAAO,YAAY,CAAC,IAAuB,CAAC,CAAC;AAC/C,CAAC;AAED,oFAAoF;AACpF,wFAAwF;AACxF,wFAAwF;AACxF,sBAAsB;AACtB,MAAM,UAAU,kBAAkB,CAAsB,MAAsB;IAC5E,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAkC,CAAC;IAC3D,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9B,OAAO,IAA6C,CAAC;AACvD,CAAC"}
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,2FAA2F;AAC3F,0FAA0F;AAC1F,kCAAkC;AAClC,MAAM,UAAU,WAAW,CAAsB,MAAsB;IACrE,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAkC,CAAC;IAC3D,IAAI,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACnC,OAAO,IAAY,CAAC;AACtB,CAAC;AAED,oFAAoF;AACpF,wFAAwF;AACxF,wFAAwF;AACxF,sBAAsB;AACtB,MAAM,UAAU,kBAAkB,CAAsB,MAAsB;IAC5E,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAkC,CAAC;IAC3D,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9B,OAAO,IAA6C,CAAC;AACvD,CAAC"}

package/dist/entity.d.ts

@@ -1,3 +1,4 @@
-import type { Entity } from '@flighthq/types/contract';
-export declare function createEntity<Type extends object>(obj?: Type): Type & Entity;
+import type { Entity, EntityConstruction } from '@flighthq/types/contract';
+export declare function allocateEntity<Type extends Entity>(): EntityConstruction<Type>;
+export declare function finishEntity<Type extends Entity>(out: EntityConstruction<Type>): Type;
 //# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGvD,wBAAgB,YAAY,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAK3E"}
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG3E,wBAAgB,cAAc,CAAC,IAAI,SAAS,MAAM,KAAK,kBAAkB,CAAC,IAAI,CAAC,CAI9E;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI,CAErF"}

package/dist/entity.js

@@ -1,9 +1,10 @@
 import { EntityRuntimeKey } from '@flighthq/types/contract';
-export function createEntity(obj) {
-    if (!obj)
-        obj = {};
-    const entity = obj;
-    entity[EntityRuntimeKey] = undefined;
-    return entity;
+export function allocateEntity() {
+    const out = {};
+    out[EntityRuntimeKey] = undefined;
+    return out;
+}
+export function finishEntity(out) {
+    return out;
 }
 //# sourceMappingURL=entity.js.map

package/dist/entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.js","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,UAAU,YAAY,CAAsB,GAAU;IAC1D,IAAI,CAAC,GAAG;QAAE,GAAG,GAAG,EAAU,CAAC;IAC3B,MAAM,MAAM,GAAG,GAAoB,CAAC;IACpC,MAAM,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,EAA8B,CAAC;IAC3C,GAAG,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IAClC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAsB,GAA6B;IAC7E,OAAO,GAAW,CAAC;AACrB,CAAC"}

package/dist/host.d.ts

@@ -1,3 +1,4 @@
-import type { EntityWithoutRuntime, Host } from '@flighthq/types/contract';
+import type { EntityConstruction, EntityWithoutRuntime, Host } from '@flighthq/types/contract';
 export declare function createHost<Capabilities extends Partial<EntityWithoutRuntime<Host>>>(capabilities?: Readonly<Capabilities>): Host & Capabilities;
+export declare function initializeHost<Capabilities extends Partial<EntityWithoutRuntime<Host>>>(out: EntityConstruction<Host & Capabilities>, capabilities: Readonly<Capabilities>): void;
 //# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAI3E,wBAAgB,UAAU,CAAC,YAAY,SAAS,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,EACjF,YAAY,GAAE,QAAQ,CAAC,YAAY,CAAsB,GACxD,IAAI,GAAG,YAAY,CA8BrB"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAI/F,wBAAgB,UAAU,CAAC,YAAY,SAAS,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,EACjF,YAAY,GAAE,QAAQ,CAAC,YAAY,CAAsB,GACxD,IAAI,GAAG,YAAY,CAIrB;AAED,wBAAgB,cAAc,CAAC,YAAY,SAAS,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,EACrF,GAAG,EAAE,kBAAkB,CAAC,IAAI,GAAG,YAAY,CAAC,EAC5C,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,GACnC,IAAI,CA2BN"}

package/dist/host.js

@@ -1,33 +1,35 @@
-import { createEntity } from './entity';
+import { allocateEntity, finishEntity } from './entity';
 export function createHost(capabilities = {}) {
-    return createEntity({
-        accessibility: {},
-        app: {},
-        clipboard: {},
-        connectivity: {},
-        dialog: {},
-        graphics: {},
-        input: {},
-        ipc: {},
-        media: {},
-        menu: {},
-        midi: {},
-        net: {},
-        notification: {},
-        power: {},
-        protocol: {},
-        screen: {},
-        share: {},
-        shell: {},
-        shortcut: {},
-        storage: {},
-        system: {},
-        text: {},
-        tray: {},
-        ui: {},
-        updater: {},
-        window: {},
-        ...capabilities,
-    });
+    const out = allocateEntity();
+    initializeHost(out, capabilities);
+    return finishEntity(out);
+}
+export function initializeHost(out, capabilities) {
+    out.accessibility = (capabilities.accessibility ?? {});
+    out.app = (capabilities.app ?? {});
+    out.clipboard = (capabilities.clipboard ?? {});
+    out.connectivity = (capabilities.connectivity ?? {});
+    out.dialog = (capabilities.dialog ?? {});
+    out.graphics = (capabilities.graphics ?? {});
+    out.input = (capabilities.input ?? {});
+    out.ipc = (capabilities.ipc ?? {});
+    out.media = (capabilities.media ?? {});
+    out.menu = (capabilities.menu ?? {});
+    out.midi = (capabilities.midi ?? {});
+    out.net = (capabilities.net ?? {});
+    out.notification = (capabilities.notification ?? {});
+    out.power = (capabilities.power ?? {});
+    out.protocol = (capabilities.protocol ?? {});
+    out.screen = (capabilities.screen ?? {});
+    out.share = (capabilities.share ?? {});
+    out.shell = (capabilities.shell ?? {});
+    out.shortcut = (capabilities.shortcut ?? {});
+    out.storage = (capabilities.storage ?? {});
+    out.system = (capabilities.system ?? {});
+    out.text = (capabilities.text ?? {});
+    out.tray = (capabilities.tray ?? {});
+    out.ui = (capabilities.ui ?? {});
+    out.updater = (capabilities.updater ?? {});
+    out.window = (capabilities.window ?? {});
 }
 //# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,UAAU,UAAU,CACxB,eAAuC,EAAkB;IAEzD,OAAO,YAAY,CAAC;QAClB,aAAa,EAAE,EAAE;QACjB,GAAG,EAAE,EAAE;QACP,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,GAAG,EAAE,EAAE;QACP,YAAY,EAAE,EAAE;QAChB,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,EAAE,EAAE,EAAE;QACN,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;QACV,GAAG,YAAY;KAChB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/entity",
-  "version": "0.5.1-next.815.cc08b93",
+  "version": "0.5.1-next.903.f434bc2",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,7 +38,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.5.1-next.815.cc08b93"
+    "@flighthq/types": "0.5.1-next.903.f434bc2"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/binding.test.ts

@@ -1,3 +1,4 @@
+import type { Entity } from '@flighthq/types/contract';
 import { EntityRuntimeKey } from '@flighthq/types/contract';
 
 import {
@@ -7,26 +8,30 @@ import {
   getEntityBindingAs,
   hasEntityBinding,
 } from './binding';
-import { createEntity } from './entity';
+import { allocateEntity, finishEntity } from './entity';
 import { createEntityRuntime, getEntityRuntime } from './runtime';
 
+function createTestEntity(): Entity {
+  return finishEntity(allocateEntity<Entity>());
+}
+
 describe('attachEntityBinding', () => {
   it('creates a runtime object if none is present', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     expect(getEntityRuntime(entity)).toBeUndefined();
     attachEntityBinding(entity, {});
     expect(getEntityRuntime(entity)).not.toBeUndefined();
   });
 
   it('assigns to the binding slot', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     const binding = {};
     attachEntityBinding(entity, binding);
     expect(getEntityRuntime(entity).binding).toStrictEqual(binding);
   });
 
   it('preserves an existing runtime while assigning its binding', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     const runtime = createEntityRuntime();
     const binding = {};
     entity[EntityRuntimeKey] = runtime;
@@ -40,7 +45,7 @@ describe('attachEntityBinding', () => {
 
 describe('detachEntityBinding', () => {
   it('clears the binding while preserving the runtime', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     const runtime = createEntityRuntime();
     runtime.binding = {};
     entity[EntityRuntimeKey] = runtime;
@@ -52,7 +57,7 @@ describe('detachEntityBinding', () => {
   });
 
   it('does not allocate a runtime when no binding exists', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
 
     detachEntityBinding(entity);
 
@@ -62,18 +67,18 @@ describe('detachEntityBinding', () => {
 
 describe('getEntityBinding', () => {
   it('returns null if the entity has no runtime', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     expect(getEntityBinding(entity)).toBeNull();
   });
 
   it('returns null if the binding slot is empty', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     entity[EntityRuntimeKey] = createEntityRuntime();
     expect(getEntityBinding(entity)).toBeNull();
   });
 
   it('returns the binding slot if set', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     const runtime = createEntityRuntime();
     runtime.binding = {};
     entity[EntityRuntimeKey] = runtime;
@@ -81,14 +86,14 @@ describe('getEntityBinding', () => {
   });
 
   it('accepts a readonly entity', () => {
-    const entity: Readonly<ReturnType<typeof createEntity>> = createEntity();
+    const entity: Readonly<Entity> = createTestEntity();
     expect(getEntityBinding(entity)).toBeNull();
   });
 });
 
 describe('getEntityBindingAs', () => {
   it('returns the binding with the caller-owned type', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     const binding = { name: 'wrapper' };
     attachEntityBinding(entity, binding);
 
@@ -99,25 +104,25 @@ describe('getEntityBindingAs', () => {
   });
 
   it('returns null if no binding exists', () => {
-    const entity: Readonly<ReturnType<typeof createEntity>> = createEntity();
+    const entity: Readonly<Entity> = createTestEntity();
     expect(getEntityBindingAs<{ name: string }>(entity)).toBeNull();
   });
 });
 
 describe('hasEntityBinding', () => {
   it('returns false if the entity has no runtime', () => {
-    const entity: Readonly<ReturnType<typeof createEntity>> = createEntity();
+    const entity: Readonly<Entity> = createTestEntity();
     expect(hasEntityBinding(entity)).toBe(false);
   });
 
   it('returns false if the binding slot is empty', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     entity[EntityRuntimeKey] = createEntityRuntime();
     expect(hasEntityBinding(entity)).toBe(false);
   });
 
   it('returns true if a binding exists', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     attachEntityBinding(entity, {});
     expect(hasEntityBinding(entity)).toBe(true);
   });

package/src/clone.test.ts

@@ -1,20 +1,27 @@
+import type { Entity } from '@flighthq/types/contract';
 import { EntityRuntimeKey } from '@flighthq/types/contract';
 
 import { attachEntityBinding } from './binding';
 import { cloneEntity, stripEntityRuntime } from './clone';
-import { createEntity } from './entity';
+import { allocateEntity, finishEntity } from './entity';
 import { hasEntityRuntime } from './runtime';
 
+function createTestEntity(fields?: Record<string, unknown>): Entity & Record<string, unknown> {
+  const out = allocateEntity<Entity>();
+  if (fields) Object.assign(out, fields);
+  return finishEntity(out) as Entity & Record<string, unknown>;
+}
+
 describe('cloneEntity', () => {
   it('returns a new entity with the same public data fields', () => {
-    const source = createEntity({ x: 1, y: 2 });
+    const source = createTestEntity({ x: 1, y: 2 });
     const clone = cloneEntity(source);
     expect(clone.x).toBe(1);
     expect(clone.y).toBe(2);
   });
 
   it('resets the runtime slot to undefined on the clone', () => {
-    const source = createEntity();
+    const source = createTestEntity();
     attachEntityBinding(source, {});
     expect(hasEntityRuntime(source)).toBe(true);
     const clone = cloneEntity(source);
@@ -22,20 +29,20 @@ describe('cloneEntity', () => {
   });
 
   it('does not share the runtime between source and clone', () => {
-    const source = createEntity();
+    const source = createTestEntity();
     const clone = cloneEntity(source);
     expect(clone[EntityRuntimeKey]).toBeUndefined();
     expect(clone).not.toBe(source);
   });
 
   it('returns a new object reference', () => {
-    const source = createEntity();
+    const source = createTestEntity();
     const clone = cloneEntity(source);
     expect(clone).not.toBe(source);
   });
 
   it('clone of a bound entity yields an unbound clone', () => {
-    const source = createEntity({ name: 'test' });
+    const source = createTestEntity({ name: 'test' });
     attachEntityBinding(source, { hostRef: 42 });
     const clone = cloneEntity(source);
     expect(hasEntityRuntime(clone)).toBe(false);
@@ -45,38 +52,40 @@ describe('cloneEntity', () => {
 
 describe('stripEntityRuntime', () => {
   it('removes the EntityRuntimeKey slot', () => {
-    const entity = createEntity({ x: 10 });
+    const entity = createTestEntity({ x: 10 });
     const stripped = stripEntityRuntime(entity);
     expect((stripped as Record<PropertyKey, unknown>)[EntityRuntimeKey]).toBeUndefined();
   });
 
   it('retains the public data fields', () => {
-    const entity = createEntity({ x: 10, y: 20 });
+    const entity = createTestEntity({ x: 10, y: 20 });
     const stripped = stripEntityRuntime(entity);
     expect(stripped.x).toBe(10);
     expect(stripped.y).toBe(20);
   });
 
   it('does not mutate the source entity', () => {
-    const entity = createEntity({ x: 10 });
+    const entity = createTestEntity({ x: 10 });
     stripEntityRuntime(entity);
     expect(entity[EntityRuntimeKey]).toBeUndefined();
   });
 
   it('strips bound entity — binding is not in the output', () => {
-    const entity = createEntity({ label: 'hello' });
+    const entity = createTestEntity({ label: 'hello' });
     attachEntityBinding(entity, { nativeRef: true });
     const stripped = stripEntityRuntime(entity);
     expect((stripped as Record<PropertyKey, unknown>)[EntityRuntimeKey]).toBeUndefined();
     expect(stripped.label).toBe('hello');
   });
 
-  it('round-trips: stripEntityRuntime then createEntity yields a valid unbound entity', () => {
-    const original = createEntity({ value: 99 });
+  it('round-trips: stripEntityRuntime then allocateEntity yields a valid unbound entity', () => {
+    const original = createTestEntity({ value: 99 });
     attachEntityBinding(original, {});
     const stripped = stripEntityRuntime(original);
-    const restored = createEntity(stripped);
-    expect(restored.value).toBe(99);
+    const out = allocateEntity<Entity>();
+    Object.assign(out, stripped);
+    const restored = finishEntity(out);
+    expect((restored as unknown as Record<string, unknown>).value).toBe(99);
     expect(hasEntityRuntime(restored)).toBe(false);
   });
 });

package/src/enableEntityRuntimeGuards.test.ts

@@ -1,11 +1,16 @@
+import type { Entity } from '@flighthq/types/contract';
 import type { EntityRuntimeWriteSlot } from '@flighthq/types/contract';
 import { EntityRuntimeKey } from '@flighthq/types/contract';
 
 import { disableEntityRuntimeGuards, enableEntityRuntimeGuards } from './enableEntityRuntimeGuards';
-import { createEntity } from './entity';
+import { allocateEntity, finishEntity } from './entity';
 import { areEntityRuntimeGuardsEnabled, createGuardedEntity, createGuardedEntityRuntime } from './guards';
 import { createEntityRuntime } from './runtime';
 
+function createTestEntity(): Entity {
+  return finishEntity(allocateEntity<Entity>());
+}
+
 // Every case runs the write under a reporter that records the slot, so what is asserted is what the
 // caller's reporter actually received — not that some sink somewhere was touched.
 function recordSlots(write: () => void): readonly EntityRuntimeWriteSlot[] {
@@ -24,7 +29,7 @@ describe('disableEntityRuntimeGuards', () => {
     const slots: EntityRuntimeWriteSlot[] = [];
     enableEntityRuntimeGuards((slot) => slots.push(slot));
     disableEntityRuntimeGuards();
-    createGuardedEntity(createEntity())[EntityRuntimeKey] = undefined;
+    createGuardedEntity(createTestEntity())[EntityRuntimeKey] = undefined;
     expect(slots).toEqual([]);
     expect(areEntityRuntimeGuardsEnabled()).toBe(false);
   });
@@ -32,7 +37,7 @@ describe('disableEntityRuntimeGuards', () => {
 
 describe('enableEntityRuntimeGuards', () => {
   it('REPORTS a direct runtime-slot write to the caller-supplied reporter', () => {
-    expect(recordSlots(() => (createGuardedEntity(createEntity())[EntityRuntimeKey] = undefined))).toEqual([
+    expect(recordSlots(() => (createGuardedEntity(createTestEntity())[EntityRuntimeKey] = undefined))).toEqual([
       'runtime-slot',
     ]);
   });
@@ -45,7 +50,7 @@ describe('enableEntityRuntimeGuards', () => {
 
   it('stays SILENT without the guard — the production default', () => {
     const slots: EntityRuntimeWriteSlot[] = [];
-    createGuardedEntity(createEntity())[EntityRuntimeKey] = undefined;
+    createGuardedEntity(createTestEntity())[EntityRuntimeKey] = undefined;
     expect(slots).toEqual([]);
     expect(areEntityRuntimeGuardsEnabled()).toBe(false);
   });

package/src/entity.test.ts

@@ -1,15 +1,20 @@
+import type { Entity } from '@flighthq/types/contract';
 import { EntityRuntimeKey } from '@flighthq/types/contract';
 
-import { createEntity } from './entity';
+import { allocateEntity, finishEntity } from './entity';
 
-describe('createEntity', () => {
-  it('returns an object', () => {
-    const entity = createEntity();
-    expect(entity).not.toBeNull();
+describe('allocateEntity', () => {
+  it('returns an object with an undefined runtime', () => {
+    const out = allocateEntity<Entity>();
+    expect(out).not.toBeNull();
+    expect(out[EntityRuntimeKey]).toBeUndefined();
   });
+});
 
-  it('has an undefined runtime', () => {
-    const entity = createEntity();
-    expect(entity[EntityRuntimeKey]).toBeUndefined();
+describe('finishEntity', () => {
+  it('returns the same object', () => {
+    const out = allocateEntity<Entity>();
+    const entity = finishEntity(out);
+    expect(entity).toBe(out);
   });
 });

package/src/entityUid.test.ts

@@ -1,38 +1,43 @@
+import type { Entity } from '@flighthq/types/contract';
 import { EntityRuntimeKey } from '@flighthq/types/contract';
 
-import { createEntity } from './entity';
+import { allocateEntity, finishEntity } from './entity';
 import { getEntityUid, setEntityUid } from './entityUid';
 import { createEntityRuntime } from './runtime';
 
+function createTestEntity(): Entity {
+  return finishEntity(allocateEntity<Entity>());
+}
+
 describe('getEntityUid', () => {
   it('has no uid property on an untouched runtime before any access', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     entity[EntityRuntimeKey] = createEntityRuntime();
     expect('uid' in entity[EntityRuntimeKey]!).toBe(false);
   });
 
   it('lazily generates a uid on first access', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     const uid = getEntityUid(entity);
     expect(uid).toEqual(expect.any(String));
     expect(uid.length).toBeGreaterThan(0);
   });
 
   it('returns the same uid on repeated access', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     const first = getEntityUid(entity);
     const second = getEntityUid(entity);
     expect(second).toBe(first);
   });
 
   it('generates distinct uids for different entities', () => {
-    const a = createEntity();
-    const b = createEntity();
+    const a = createTestEntity();
+    const b = createTestEntity();
     expect(getEntityUid(a)).not.toBe(getEntityUid(b));
   });
 
   it('creates the runtime if the entity has none', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     expect(entity[EntityRuntimeKey]).toBeUndefined();
     getEntityUid(entity);
     expect(entity[EntityRuntimeKey]).toBeDefined();
@@ -41,13 +46,13 @@ describe('getEntityUid', () => {
 
 describe('setEntityUid', () => {
   it('sets a stable id before any get', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     setEntityUid(entity, 'my-stable-id');
     expect(getEntityUid(entity)).toBe('my-stable-id');
   });
 
   it('replaces a previously generated uid', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     const generated = getEntityUid(entity);
     setEntityUid(entity, 'override');
     expect(getEntityUid(entity)).toBe('override');
@@ -55,7 +60,7 @@ describe('setEntityUid', () => {
   });
 
   it('creates the runtime if the entity has none', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     expect(entity[EntityRuntimeKey]).toBeUndefined();
     setEntityUid(entity, 'pre-bind');
     expect(entity[EntityRuntimeKey]).toBeDefined();

package/src/guards.test.ts

@@ -1,7 +1,8 @@
+import type { Entity } from '@flighthq/types/contract';
 import { EntityRuntimeKey } from '@flighthq/types/contract';
 import type { EntityRuntimeWriteSlot } from '@flighthq/types/contract';
 
-import { createEntity } from './entity';
+import { allocateEntity, finishEntity } from './entity';
 import {
   areEntityRuntimeGuardsEnabled,
   createGuardedEntity,
@@ -11,6 +12,12 @@ import {
 } from './guards';
 import { createEntityRuntime } from './runtime';
 
+function createTestEntity(fields?: Record<string, unknown>): Entity & Record<string, unknown> {
+  const out = allocateEntity<Entity>();
+  if (fields) Object.assign(out, fields);
+  return finishEntity(out) as Entity & Record<string, unknown>;
+}
+
 describe('areEntityRuntimeGuardsEnabled', () => {
   it('returns false before guard mode is switched on', () => {
     // Vitest isolates modules per file, so this starts false in a fresh module import.
@@ -20,7 +27,7 @@ describe('areEntityRuntimeGuardsEnabled', () => {
 
 describe('createGuardedEntity', () => {
   it('returns the entity unchanged when guards are not enabled', () => {
-    const entity = createEntity({ x: 1 });
+    const entity = createTestEntity({ x: 1 });
     expect(createGuardedEntity(entity)).toBe(entity);
   });
 });
@@ -37,7 +44,7 @@ describe('setEntityRuntimeGuardMode', () => {
     setEntityRuntimeGuardMode(true);
     try {
       expect(areEntityRuntimeGuardsEnabled()).toBe(true);
-      const entity = createEntity({ x: 1 });
+      const entity = createTestEntity({ x: 1 });
       expect(createGuardedEntity(entity).x).toBe(1);
       expect(createGuardedEntityRuntime(createEntityRuntime()).binding).toBeNull();
     } finally {
@@ -62,7 +69,7 @@ describe('setEntityRuntimeGuardMode', () => {
   });
 
   it('returns the original values when Proxy disappears after guards are enabled', () => {
-    const entity = createEntity({ x: 1 });
+    const entity = createTestEntity({ x: 1 });
     const runtime = createEntityRuntime();
     const originalProxy = globalThis.Proxy;
     let guardedEntity: typeof entity;
@@ -88,7 +95,7 @@ describe('setEntityRuntimeWriteGuard', () => {
     setEntityRuntimeGuardMode(true);
     setEntityRuntimeWriteGuard((slot) => slots.push(slot));
     try {
-      const guardedEntity = createGuardedEntity(createEntity());
+      const guardedEntity = createGuardedEntity(createTestEntity());
       guardedEntity[EntityRuntimeKey] = undefined;
       const guardedRuntime = createGuardedEntityRuntime(createEntityRuntime());
       guardedRuntime.binding = null;
@@ -107,7 +114,7 @@ describe('setEntityRuntimeWriteGuard', () => {
     setEntityRuntimeWriteGuard((slot) => slots.push(slot));
     setEntityRuntimeWriteGuard(null);
     try {
-      createGuardedEntity(createEntity())[EntityRuntimeKey] = undefined;
+      createGuardedEntity(createTestEntity())[EntityRuntimeKey] = undefined;
       expect(slots).toEqual([]);
     } finally {
       setEntityRuntimeGuardMode(false);
@@ -119,7 +126,7 @@ describe('setEntityRuntimeWriteGuard', () => {
     setEntityRuntimeGuardMode(true);
     setEntityRuntimeWriteGuard((slot) => slots.push(slot));
     try {
-      const guardedEntity = createGuardedEntity(createEntity({ x: 1 }));
+      const guardedEntity = createGuardedEntity(createTestEntity({ x: 1 }));
       guardedEntity.x = 2;
       const guardedRuntime = createGuardedEntityRuntime(createEntityRuntime()) as ReturnType<
         typeof createEntityRuntime
@@ -138,7 +145,7 @@ describe('setEntityRuntimeWriteGuard', () => {
     const slots: EntityRuntimeWriteSlot[] = [];
     setEntityRuntimeGuardMode(true);
     setEntityRuntimeWriteGuard((slot) => slots.push(slot));
-    const guardedEntity = createGuardedEntity(createEntity());
+    const guardedEntity = createGuardedEntity(createTestEntity());
     const guardedRuntime = createGuardedEntityRuntime(createEntityRuntime());
     setEntityRuntimeGuardMode(false);
     try {

package/src/runtime.test.ts

@@ -1,10 +1,15 @@
+import type { Entity } from '@flighthq/types/contract';
 import type { EntityRuntime } from '@flighthq/types/contract';
 import { EntityRuntimeKey } from '@flighthq/types/contract';
 
 import { attachEntityBinding } from './binding';
-import { createEntity } from './entity';
+import { allocateEntity, finishEntity } from './entity';
 import { createEntityRuntime, getEntityRuntime, hasEntityRuntime } from './runtime';
 
+function createTestEntity(): Entity {
+  return finishEntity(allocateEntity<Entity>());
+}
+
 describe('createEntityRuntime', () => {
   it('returns an object', () => {
     const runtime = createEntityRuntime();
@@ -19,7 +24,7 @@ describe('createEntityRuntime', () => {
 
 describe('getEntityRuntime', () => {
   it('returns the runtime object', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     expect(getEntityRuntime(entity)).toBeUndefined();
     const runtime = {} as EntityRuntime;
     entity[EntityRuntimeKey] = runtime;
@@ -29,12 +34,12 @@ describe('getEntityRuntime', () => {
 
 describe('hasEntityRuntime', () => {
   it('returns false for a fresh entity', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     expect(hasEntityRuntime(entity)).toBe(false);
   });
 
   it('returns true after a binding is attached', () => {
-    const entity = createEntity();
+    const entity = createTestEntity();
     attachEntityBinding(entity, {});
     expect(hasEntityRuntime(entity)).toBe(true);
   });