@flighthq/entity 0.5.0-next.1944.cd6b6e7 → 0.5.1-next.597.ab004dd

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.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/entity)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/entity@0.5.1-next.597.ab004dd](https://github.com/flighthq/flight/tree/ab004ddc85b350cbd99a944e1e8108a016ae8af0/packages/entity)
+- [License](https://github.com/flighthq/flight/blob/ab004ddc85b350cbd99a944e1e8108a016ae8af0/LICENSE.md)

package/dist/contract.d.ts

@@ -3,5 +3,6 @@ export * from './clone';
 export * from './entity';
 export * from './enableEntityRuntimeGuards';
 export * from './guards';
+export * from './host';
 export * from './runtime';
 //# sourceMappingURL=contract.d.ts.map

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,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,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/contract.js

@@ -3,5 +3,6 @@ export * from './clone';
 export * from './entity';
 export * from './enableEntityRuntimeGuards';
 export * from './guards';
+export * from './host';
 export * from './runtime';
 //# sourceMappingURL=contract.js.map

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,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,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/host.d.ts

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

package/dist/host.d.ts.map

@@ -0,0 +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"}

package/dist/host.js

@@ -0,0 +1,33 @@
+import { createEntity } 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,
+    });
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/entity",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-next.597.ab004dd",
   "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.0-next.1944.cd6b6e7",
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/log": "0.5.1-next.597.ab004dd",
+    "@flighthq/types": "0.5.1-next.597.ab004dd"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/host.test.ts

@@ -0,0 +1,71 @@
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+
+import * as entity from './contract';
+
+const HOST_GROUPS = [
+  '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',
+] as const;
+
+describe('createHost', () => {
+  it('creates an Entity immediately while leaving its runtime allocation lazy', () => {
+    const host = requiredFunction(entity, 'createHost')();
+
+    expect(EntityRuntimeKey in host).toBe(true);
+    expect(host[EntityRuntimeKey]).toBeUndefined();
+  });
+
+  it('materializes the complete stable Host shape with truthful empty groups', () => {
+    const host = requiredFunction(entity, 'createHost')();
+
+    expect(
+      Object.keys(host)
+        .filter((key) => key !== String(EntityRuntimeKey))
+        .sort(),
+    ).toEqual(HOST_GROUPS);
+    for (const group of HOST_GROUPS) expect(host[group]).toEqual({});
+  });
+
+  it('preserves supplied capability-group and provider identities without populating another group', () => {
+    const provider = {};
+    const accessibility = { provider };
+    const host = requiredFunction(entity, 'createHost')({ accessibility });
+
+    expect(host.accessibility).toBe(accessibility);
+    expect(host.accessibility.provider).toBe(provider);
+    for (const group of HOST_GROUPS) {
+      if (group !== 'accessibility') expect(host[group]).toEqual({});
+    }
+  });
+});
+
+function requiredFunction(module: object, name: string): (...args: any[]) => any {
+  const value = Reflect.get(module, name);
+  expect(value, `${name} export`).toBeTypeOf('function');
+  if (typeof value !== 'function') throw new TypeError(`${name} is not exported`);
+  return value as (...args: any[]) => any;
+}