@flighthq/entity 0.5.1-next.601.e6e16ba → 0.5.1-next.638.d4dbd4e

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.601.e6e16ba](https://github.com/flighthq/flight/tree/e6e16ba4e02530d9579d14d496d5df29f0784c68/packages/entity)
-- [License](https://github.com/flighthq/flight/blob/e6e16ba4e02530d9579d14d496d5df29f0784c68/LICENSE.md)
+- [Source for @flighthq/entity@0.5.1-next.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/entity)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/contract.d.ts

@@ -2,6 +2,7 @@ export * from './binding';
 export * from './clone';
 export * from './entity';
 export * from './enableEntityRuntimeGuards';
+export * from './entityUid';
 export * from './guards';
 export * from './host';
 export * from './runtime';

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/contract.js

@@ -2,6 +2,7 @@ export * from './binding';
 export * from './clone';
 export * from './entity';
 export * from './enableEntityRuntimeGuards';
+export * from './entityUid';
 export * from './guards';
 export * from './host';
 export * from './runtime';

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/entityUid.d.ts

@@ -0,0 +1,4 @@
+import type { Entity } from '@flighthq/types/contract';
+export declare function getEntityUid(source: Entity): string;
+export declare function setEntityUid(source: Entity, uid: string): void;
+//# sourceMappingURL=entityUid.d.ts.map

package/dist/entityUid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityUid.d.ts","sourceRoot":"","sources":["../src/entityUid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,0BAA0B,CAAC;AAKtE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAG9D"}

package/dist/entityUid.js

@@ -0,0 +1,25 @@
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+import { createEntityRuntime } from './runtime';
+export function getEntityUid(source) {
+    const runtime = ensureEntityRuntime(source);
+    if (runtime.uid !== undefined)
+        return runtime.uid;
+    const uid = generateEntityUid();
+    runtime.uid = uid;
+    return uid;
+}
+export function setEntityUid(source, uid) {
+    const runtime = ensureEntityRuntime(source);
+    runtime.uid = uid;
+}
+function ensureEntityRuntime(source) {
+    if (source[EntityRuntimeKey] === undefined) {
+        source[EntityRuntimeKey] = createEntityRuntime();
+    }
+    return source[EntityRuntimeKey];
+}
+function generateEntityUid() {
+    return `entity-${_nextEntityUidCounter++}`;
+}
+let _nextEntityUidCounter = 1;
+//# sourceMappingURL=entityUid.js.map

package/dist/entityUid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityUid.js","sourceRoot":"","sources":["../src/entityUid.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAClD,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;IAClB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,GAAW;IACtD,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,IAAI,MAAM,CAAC,gBAAgB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,CAAC,gBAAgB,CAAC,GAAG,mBAAmB,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,gBAAgB,CAAE,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,UAAU,qBAAqB,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,IAAI,qBAAqB,GAAG,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export {} from './contract';
+export { getEntityUid, setEntityUid } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export {};
+export { getEntityUid, setEntityUid } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/entity",
-  "version": "0.5.1-next.601.e6e16ba",
+  "version": "0.5.1-next.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/log": "0.5.1-next.601.e6e16ba",
-    "@flighthq/types": "0.5.1-next.601.e6e16ba"
+    "@flighthq/log": "0.5.1-next.638.d4dbd4e",
+    "@flighthq/types": "0.5.1-next.638.d4dbd4e"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/entityUid.test.ts

@@ -0,0 +1,64 @@
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+
+import { createEntity } from './entity';
+import { getEntityUid, setEntityUid } from './entityUid';
+import { createEntityRuntime } from './runtime';
+
+describe('getEntityUid', () => {
+  it('has no uid property on an untouched runtime before any access', () => {
+    const entity = createEntity();
+    entity[EntityRuntimeKey] = createEntityRuntime();
+    expect('uid' in entity[EntityRuntimeKey]!).toBe(false);
+  });
+
+  it('lazily generates a uid on first access', () => {
+    const entity = createEntity();
+    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 first = getEntityUid(entity);
+    const second = getEntityUid(entity);
+    expect(second).toBe(first);
+  });
+
+  it('generates distinct uids for different entities', () => {
+    const a = createEntity();
+    const b = createEntity();
+    expect(getEntityUid(a)).not.toBe(getEntityUid(b));
+  });
+
+  it('creates the runtime if the entity has none', () => {
+    const entity = createEntity();
+    expect(entity[EntityRuntimeKey]).toBeUndefined();
+    getEntityUid(entity);
+    expect(entity[EntityRuntimeKey]).toBeDefined();
+  });
+});
+
+describe('setEntityUid', () => {
+  it('sets a stable id before any get', () => {
+    const entity = createEntity();
+    setEntityUid(entity, 'my-stable-id');
+    expect(getEntityUid(entity)).toBe('my-stable-id');
+  });
+
+  it('replaces a previously generated uid', () => {
+    const entity = createEntity();
+    const generated = getEntityUid(entity);
+    setEntityUid(entity, 'override');
+    expect(getEntityUid(entity)).toBe('override');
+    expect(getEntityUid(entity)).not.toBe(generated);
+  });
+
+  it('creates the runtime if the entity has none', () => {
+    const entity = createEntity();
+    expect(entity[EntityRuntimeKey]).toBeUndefined();
+    setEntityUid(entity, 'pre-bind');
+    expect(entity[EntityRuntimeKey]).toBeDefined();
+    expect(getEntityUid(entity)).toBe('pre-bind');
+  });
+});