@knpkv/hub-app 0.0.0-stage → 0.2.0

package/dist/manifest.d.ts

@@ -0,0 +1,267 @@
+/**
+ * What an app says about itself, what nix tells the hub, and what the hub concludes per app.
+ *
+ * **Mental model**
+ *
+ * - `apps.json` (written by nix) holds only ids and sockets. Everything else comes from the app's own
+ *   `GET /app/manifest`, so the file can't disagree with the code.
+ * - `contract` is one integer for the whole shell ↔ app surface: manifest shape, wire paths, shell
+ *   services and `ShellContext`. Additive changes keep it; the hub supports the current and previous one.
+ * - Every per-app problem becomes an {@link AppState} `Unavailable`, never a hub failure.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+/** Contracts this package's runner and types speak. The hub declares its own supported list. */
+export declare const AppContract: Schema.Literals<readonly [1]>;
+export type AppContract = typeof AppContract.Type;
+export declare const AppId: Schema.brand<Schema.String, "AppId">;
+export type AppId = typeof AppId.Type;
+/** Hub services an app may call; an undeclared one fails with `ShellServiceUnavailable("undeclared")`. */
+export declare const ShellService: Schema.Literals<readonly ["fleet.read", "host", "jobs.submit", "relay.post", "needs-you", "badge"]>;
+export type ShellService = typeof ShellService.Type;
+/** The client the runner serves under `/app/assets/`: one ES module entry and its stylesheets. */
+export declare const AppClientAssets: Schema.Struct<{
+    readonly entry: Schema.String;
+    readonly css: Schema.$Array<Schema.String>;
+}>;
+export type AppClientAssets = typeof AppClientAssets.Type;
+/** Served at `GET /app/manifest`. `module.id` is the app id; the version is display-only. */
+export declare const AppManifest: Schema.Struct<{
+    readonly contract: Schema.Int;
+    readonly id: Schema.brand<Schema.String, "AppId">;
+    readonly package: Schema.String;
+    readonly version: Schema.String;
+    readonly module: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly label: Schema.String;
+        readonly defaultPage: Schema.String;
+        readonly pages: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+            readonly showInPhoneTitle: Schema.optionalKey<Schema.Boolean>;
+        }>>;
+        readonly listeners: Schema.$Array<Schema.Literals<readonly ["serve", "local", "approval", "tailnet", "lan"]>>;
+        readonly requires: Schema.$Array<Schema.Literals<readonly ["read", "write"]>>;
+    }>;
+    readonly client: Schema.Struct<{
+        readonly entry: Schema.String;
+        readonly css: Schema.$Array<Schema.String>;
+    }>;
+    readonly services: Schema.$Array<Schema.Literals<readonly ["fleet.read", "host", "jobs.submit", "relay.post", "needs-you", "badge"]>>;
+    readonly nav: Schema.Struct<{
+        readonly order: Schema.Int;
+        readonly primary: Schema.Boolean;
+        readonly mobile: Schema.Boolean;
+    }>;
+    readonly standalone: Schema.Struct<{
+        readonly defaultPort: Schema.Int;
+    }>;
+}>;
+export interface AppManifest extends Schema.Schema.Type<typeof AppManifest> {
+}
+/** What an app declares in code; the runner adds `client` from its build output. */
+export type AppManifestInput = Omit<AppManifest, "client">;
+/** `~/.config/herdr/apps.json`, written by nix. Unknown keys are refused. */
+export declare const AppsConfig: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly apps: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.brand<Schema.String, "AppId">;
+        readonly socket: Schema.String;
+    }>>;
+}>;
+export interface AppsConfig extends Schema.Schema.Type<typeof AppsConfig> {
+}
+export declare const AppUnavailableReason: Schema.Literals<readonly ["not_running", "timeout", "invalid_manifest", "id_mismatch", "incompatible", "duplicate", "client_failed"]>;
+export type AppUnavailableReason = typeof AppUnavailableReason.Type;
+/**
+ * The hub's view of one registered app, served by `GET /v1/apps`. `Unavailable` keeps the last good
+ * manifest, when there is one, so the shell still shows the app's real label and pages.
+ */
+export declare const AppState: Schema.Union<readonly [Schema.TaggedStruct<"Ready", {
+    readonly manifest: Schema.Struct<{
+        readonly contract: Schema.Int;
+        readonly id: Schema.brand<Schema.String, "AppId">;
+        readonly package: Schema.String;
+        readonly version: Schema.String;
+        readonly module: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+            readonly defaultPage: Schema.String;
+            readonly pages: Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly label: Schema.String;
+                readonly showInPhoneTitle: Schema.optionalKey<Schema.Boolean>;
+            }>>;
+            readonly listeners: Schema.$Array<Schema.Literals<readonly ["serve", "local", "approval", "tailnet", "lan"]>>;
+            readonly requires: Schema.$Array<Schema.Literals<readonly ["read", "write"]>>;
+        }>;
+        readonly client: Schema.Struct<{
+            readonly entry: Schema.String;
+            readonly css: Schema.$Array<Schema.String>;
+        }>;
+        readonly services: Schema.$Array<Schema.Literals<readonly ["fleet.read", "host", "jobs.submit", "relay.post", "needs-you", "badge"]>>;
+        readonly nav: Schema.Struct<{
+            readonly order: Schema.Int;
+            readonly primary: Schema.Boolean;
+            readonly mobile: Schema.Boolean;
+        }>;
+        readonly standalone: Schema.Struct<{
+            readonly defaultPort: Schema.Int;
+        }>;
+    }>;
+}>, Schema.TaggedStruct<"Unavailable", {
+    readonly id: Schema.brand<Schema.String, "AppId">;
+    readonly manifest: Schema.NullOr<Schema.Struct<{
+        readonly contract: Schema.Int;
+        readonly id: Schema.brand<Schema.String, "AppId">;
+        readonly package: Schema.String;
+        readonly version: Schema.String;
+        readonly module: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+            readonly defaultPage: Schema.String;
+            readonly pages: Schema.$Array<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly label: Schema.String;
+                readonly showInPhoneTitle: Schema.optionalKey<Schema.Boolean>;
+            }>>;
+            readonly listeners: Schema.$Array<Schema.Literals<readonly ["serve", "local", "approval", "tailnet", "lan"]>>;
+            readonly requires: Schema.$Array<Schema.Literals<readonly ["read", "write"]>>;
+        }>;
+        readonly client: Schema.Struct<{
+            readonly entry: Schema.String;
+            readonly css: Schema.$Array<Schema.String>;
+        }>;
+        readonly services: Schema.$Array<Schema.Literals<readonly ["fleet.read", "host", "jobs.submit", "relay.post", "needs-you", "badge"]>>;
+        readonly nav: Schema.Struct<{
+            readonly order: Schema.Int;
+            readonly primary: Schema.Boolean;
+            readonly mobile: Schema.Boolean;
+        }>;
+        readonly standalone: Schema.Struct<{
+            readonly defaultPort: Schema.Int;
+        }>;
+    }>>;
+    readonly reason: Schema.Literals<readonly ["not_running", "timeout", "invalid_manifest", "id_mismatch", "incompatible", "duplicate", "client_failed"]>;
+    readonly detail: Schema.String;
+}>]>;
+export type AppState = typeof AppState.Type;
+export declare const AppStates: Schema.Struct<{
+    readonly contract: Schema.Literals<readonly [1]>;
+    readonly apps: Schema.$Array<Schema.Union<readonly [Schema.TaggedStruct<"Ready", {
+        readonly manifest: Schema.Struct<{
+            readonly contract: Schema.Int;
+            readonly id: Schema.brand<Schema.String, "AppId">;
+            readonly package: Schema.String;
+            readonly version: Schema.String;
+            readonly module: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly label: Schema.String;
+                readonly defaultPage: Schema.String;
+                readonly pages: Schema.$Array<Schema.Struct<{
+                    readonly id: Schema.String;
+                    readonly label: Schema.String;
+                    readonly showInPhoneTitle: Schema.optionalKey<Schema.Boolean>;
+                }>>;
+                readonly listeners: Schema.$Array<Schema.Literals<readonly ["serve", "local", "approval", "tailnet", "lan"]>>;
+                readonly requires: Schema.$Array<Schema.Literals<readonly ["read", "write"]>>;
+            }>;
+            readonly client: Schema.Struct<{
+                readonly entry: Schema.String;
+                readonly css: Schema.$Array<Schema.String>;
+            }>;
+            readonly services: Schema.$Array<Schema.Literals<readonly ["fleet.read", "host", "jobs.submit", "relay.post", "needs-you", "badge"]>>;
+            readonly nav: Schema.Struct<{
+                readonly order: Schema.Int;
+                readonly primary: Schema.Boolean;
+                readonly mobile: Schema.Boolean;
+            }>;
+            readonly standalone: Schema.Struct<{
+                readonly defaultPort: Schema.Int;
+            }>;
+        }>;
+    }>, Schema.TaggedStruct<"Unavailable", {
+        readonly id: Schema.brand<Schema.String, "AppId">;
+        readonly manifest: Schema.NullOr<Schema.Struct<{
+            readonly contract: Schema.Int;
+            readonly id: Schema.brand<Schema.String, "AppId">;
+            readonly package: Schema.String;
+            readonly version: Schema.String;
+            readonly module: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly label: Schema.String;
+                readonly defaultPage: Schema.String;
+                readonly pages: Schema.$Array<Schema.Struct<{
+                    readonly id: Schema.String;
+                    readonly label: Schema.String;
+                    readonly showInPhoneTitle: Schema.optionalKey<Schema.Boolean>;
+                }>>;
+                readonly listeners: Schema.$Array<Schema.Literals<readonly ["serve", "local", "approval", "tailnet", "lan"]>>;
+                readonly requires: Schema.$Array<Schema.Literals<readonly ["read", "write"]>>;
+            }>;
+            readonly client: Schema.Struct<{
+                readonly entry: Schema.String;
+                readonly css: Schema.$Array<Schema.String>;
+            }>;
+            readonly services: Schema.$Array<Schema.Literals<readonly ["fleet.read", "host", "jobs.submit", "relay.post", "needs-you", "badge"]>>;
+            readonly nav: Schema.Struct<{
+                readonly order: Schema.Int;
+                readonly primary: Schema.Boolean;
+                readonly mobile: Schema.Boolean;
+            }>;
+            readonly standalone: Schema.Struct<{
+                readonly defaultPort: Schema.Int;
+            }>;
+        }>>;
+        readonly reason: Schema.Literals<readonly ["not_running", "timeout", "invalid_manifest", "id_mismatch", "incompatible", "duplicate", "client_failed"]>;
+        readonly detail: Schema.String;
+    }>]>>;
+}>;
+export interface AppStates extends Schema.Schema.Type<typeof AppStates> {
+}
+declare const AppsConfigInvalid_base: Schema.Class<AppsConfigInvalid, Schema.TaggedStruct<"AppsConfigInvalid", {
+    readonly path: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** `apps.json` exists but doesn't decode; the hub keeps its previous app list. */
+export declare class AppsConfigInvalid extends AppsConfigInvalid_base {
+}
+declare const AppProbeFailed_base: Schema.Class<AppProbeFailed, Schema.TaggedStruct<"AppProbeFailed", {
+    readonly id: Schema.brand<Schema.String, "AppId">;
+    readonly reason: Schema.Literals<readonly ["not_running", "timeout", "invalid_manifest", "id_mismatch", "incompatible", "duplicate", "client_failed"]>;
+    readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** One probe's outcome other than `Ready`. */
+export declare class AppProbeFailed extends AppProbeFailed_base {
+}
+declare const AppUnavailable_base: Schema.Class<AppUnavailable, Schema.TaggedStruct<"AppUnavailable", {
+    readonly id: Schema.brand<Schema.String, "AppId">;
+}>, import("effect/Cause").YieldableError>;
+/** A proxied request reached an app that isn't answering. The proxy answers 503 `app_unavailable`. */
+export declare class AppUnavailable extends AppUnavailable_base {
+}
+declare const GrantInvalid_base: Schema.Class<GrantInvalid, Schema.TaggedStruct<"GrantInvalid", {
+    readonly reason: Schema.Literals<readonly ["unknown", "expired", "used", "app_mismatch", "read_only"]>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * A grant the hub doesn't recognise, has expired, was already spent, belongs to another app, or was minted for a
+ * read (`read_only`: a GET skips the same-origin check, so its grant may not submit a job).
+ */
+export declare class GrantInvalid extends GrantInvalid_base {
+}
+declare const ShellServiceUnavailable_base: Schema.Class<ShellServiceUnavailable, Schema.TaggedStruct<"ShellServiceUnavailable", {
+    readonly service: Schema.Literals<readonly ["fleet.read", "host", "jobs.submit", "relay.post", "needs-you", "badge"]>;
+    readonly reason: Schema.Literals<readonly ["standalone", "undeclared", "hub_down"]>;
+}>, import("effect/Cause").YieldableError>;
+/** A shell service the app can't use here: running standalone, not declared, or the hub is down. */
+export declare class ShellServiceUnavailable extends ShellServiceUnavailable_base {
+}
+declare const AppStartError_base: Schema.Class<AppStartError, Schema.TaggedStruct<"AppStartError", {
+    readonly reason: Schema.Literals<readonly ["invalid_manifest", "invalid_arguments", "listen", "layer"]>;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** The app couldn't start: its manifest, its listener, or its handler layer. */
+export declare class AppStartError extends AppStartError_base {
+}
+export {};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,gGAAgG;AAChG,eAAO,MAAM,WAAW,+BAAuB,CAAA;AAC/C,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD,eAAO,MAAM,KAAK,sCAEjB,CAAA;AACD,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAA;AAErC,0GAA0G;AAC1G,eAAO,MAAM,YAAY,qGAA6F,CAAA;AACtH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAInD,kGAAkG;AAClG,eAAO,MAAM,eAAe;;;EAG1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,6FAA6F;AAC7F,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EActB,CAAA;AACF,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC;CAAG;AAE9E,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAI1D,6EAA6E;AAC7E,eAAO,MAAM,UAAU;;;;;;EAGrB,CAAA;AACF,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC;CAAG;AAE5E,eAAO,MAAM,oBAAoB,uIAQ/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQnB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyE,CAAA;AAC/F,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG;;;;AAE1E,kFAAkF;AAClF,qBAAa,iBAAkB,SAAQ,sBAErC;CAAG;;;;;;AAEL,8CAA8C;AAC9C,qBAAa,cAAe,SAAQ,mBAIlC;CAAG;;;;AAEL,sGAAsG;AACtG,qBAAa,cAAe,SAAQ,mBAAqE;CAAG;;;;AAE5G;;;GAGG;AACH,qBAAa,YAAa,SAAQ,iBAEhC;CAAG;;;;;AAEL,oGAAoG;AACpG,qBAAa,uBAAwB,SAAQ,4BAM5C;CAAG;;;;;AAEJ,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,kBAGjC;CAAG"}

package/dist/manifest.js

@@ -0,0 +1,107 @@
+/**
+ * What an app says about itself, what nix tells the hub, and what the hub concludes per app.
+ *
+ * **Mental model**
+ *
+ * - `apps.json` (written by nix) holds only ids and sockets. Everything else comes from the app's own
+ *   `GET /app/manifest`, so the file can't disagree with the code.
+ * - `contract` is one integer for the whole shell ↔ app surface: manifest shape, wire paths, shell
+ *   services and `ShellContext`. Additive changes keep it; the hub supports the current and previous one.
+ * - Every per-app problem becomes an {@link AppState} `Unavailable`, never a hub failure.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+import { ModuleDescriptor } from "./module.js";
+/** Contracts this package's runner and types speak. The hub declares its own supported list. */
+export const AppContract = Schema.Literals([1]);
+export const AppId = Schema.String.check(Schema.isPattern(/^[a-z][a-z0-9-]*$/), Schema.isMaxLength(64)).pipe(Schema.brand("AppId"));
+/** Hub services an app may call; an undeclared one fails with `ShellServiceUnavailable("undeclared")`. */
+export const ShellService = Schema.Literals(["fleet.read", "host", "jobs.submit", "relay.post", "needs-you", "badge"]);
+const AssetPath = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9._-]+(\/[A-Za-z0-9._-]+)*$/));
+/** The client the runner serves under `/app/assets/`: one ES module entry and its stylesheets. */
+export const AppClientAssets = Schema.Struct({
+    entry: AssetPath,
+    css: Schema.Array(AssetPath)
+});
+/** Served at `GET /app/manifest`. `module.id` is the app id; the version is display-only. */
+export const AppManifest = Schema.Struct({
+    contract: Schema.Int.check(Schema.isGreaterThanOrEqualTo(1)),
+    id: AppId,
+    package: Schema.String.check(Schema.isNonEmpty(), Schema.isMaxLength(214)),
+    version: Schema.String.check(Schema.isNonEmpty(), Schema.isMaxLength(64)),
+    module: ModuleDescriptor,
+    client: AppClientAssets,
+    services: Schema.Array(ShellService),
+    nav: Schema.Struct({
+        order: Schema.Int,
+        primary: Schema.Boolean,
+        mobile: Schema.Boolean
+    }),
+    standalone: Schema.Struct({ defaultPort: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 65_535 })) })
+});
+const SocketPath = Schema.String.check(Schema.isPattern(/^\//), Schema.isMaxLength(107));
+/** `~/.config/herdr/apps.json`, written by nix. Unknown keys are refused. */
+export const AppsConfig = Schema.Struct({
+    v: Schema.Literal(1),
+    apps: Schema.Array(Schema.Struct({ id: AppId, socket: SocketPath }))
+});
+export const AppUnavailableReason = Schema.Literals([
+    "not_running",
+    "timeout",
+    "invalid_manifest",
+    "id_mismatch",
+    "incompatible",
+    "duplicate",
+    "client_failed"
+]);
+/**
+ * The hub's view of one registered app, served by `GET /v1/apps`. `Unavailable` keeps the last good
+ * manifest, when there is one, so the shell still shows the app's real label and pages.
+ */
+export const AppState = Schema.Union([
+    Schema.TaggedStruct("Ready", { manifest: AppManifest }),
+    Schema.TaggedStruct("Unavailable", {
+        id: AppId,
+        manifest: Schema.NullOr(AppManifest),
+        reason: AppUnavailableReason,
+        detail: Schema.String
+    })
+]);
+export const AppStates = Schema.Struct({ contract: AppContract, apps: Schema.Array(AppState) });
+/** `apps.json` exists but doesn't decode; the hub keeps its previous app list. */
+export class AppsConfigInvalid extends Schema.TaggedError()("AppsConfigInvalid", {
+    path: Schema.String
+}) {
+}
+/** One probe's outcome other than `Ready`. */
+export class AppProbeFailed extends Schema.TaggedError()("AppProbeFailed", {
+    id: AppId,
+    reason: AppUnavailableReason,
+    detail: Schema.String
+}) {
+}
+/** A proxied request reached an app that isn't answering. The proxy answers 503 `app_unavailable`. */
+export class AppUnavailable extends Schema.TaggedError()("AppUnavailable", { id: AppId }) {
+}
+/**
+ * A grant the hub doesn't recognise, has expired, was already spent, belongs to another app, or was minted for a
+ * read (`read_only`: a GET skips the same-origin check, so its grant may not submit a job).
+ */
+export class GrantInvalid extends Schema.TaggedError()("GrantInvalid", {
+    reason: Schema.Literals(["unknown", "expired", "used", "app_mismatch", "read_only"])
+}) {
+}
+/** A shell service the app can't use here: running standalone, not declared, or the hub is down. */
+export class ShellServiceUnavailable extends Schema.TaggedError()("ShellServiceUnavailable", {
+    service: ShellService,
+    reason: Schema.Literals(["standalone", "undeclared", "hub_down"])
+}) {
+}
+/** The app couldn't start: its manifest, its listener, or its handler layer. */
+export class AppStartError extends Schema.TaggedError()("AppStartError", {
+    reason: Schema.Literals(["invalid_manifest", "invalid_arguments", "listen", "layer"]),
+    cause: Schema.Defect()
+}) {
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}

package/dist/module.d.ts

@@ -0,0 +1,38 @@
+/** Module metadata shared by the hub shell, its core modules and every app. Moved from herdr-hub. @module */
+import { Result, Schema } from "effect";
+export declare const ModuleListener: Schema.Literals<readonly ["serve", "local", "approval", "tailnet", "lan"]>;
+export type ModuleListener = typeof ModuleListener.Type;
+/** Shared metadata. `requires` describes UI capabilities; the server mount enforces access. */
+export declare const ModuleDescriptor: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly label: Schema.String;
+    readonly defaultPage: Schema.String;
+    readonly pages: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly label: Schema.String;
+        /** @deprecated Ignored: the phone header shows the product name and the breadcrumb names the page. */
+        readonly showInPhoneTitle: Schema.optionalKey<Schema.Boolean>;
+    }>>;
+    readonly listeners: Schema.$Array<Schema.Literals<readonly ["serve", "local", "approval", "tailnet", "lan"]>>;
+    readonly requires: Schema.$Array<Schema.Literals<readonly ["read", "write"]>>;
+}>;
+export type ModuleDescriptor = typeof ModuleDescriptor.Type;
+declare const ModuleRegistrationError_base: Schema.Class<ModuleRegistrationError, Schema.TaggedStruct<"ModuleRegistrationError", {
+    readonly module: Schema.String;
+    readonly reason: Schema.Literals<readonly ["invalid_descriptor", "duplicate_module", "duplicate_page", "missing_default", "server_mismatch", "browser_mismatch", "invalid_route", "duplicate_route"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class ModuleRegistrationError extends ModuleRegistrationError_base {
+}
+/** Reject ambiguous namespaces and missing pages before a browser or server registry is used. */
+export declare const validateModuleRegistry: (input: ReadonlyArray<ModuleDescriptor>) => Result.Result<ReadonlyArray<ModuleDescriptor>, ModuleRegistrationError>;
+/** Retains literal page identities. Registration validates this metadata before mounting it. */
+export declare const defineModule: <const D extends ModuleDescriptor>(descriptor: D) => D;
+/** Each page belongs to its descriptor; query parameters select objects inside the owning page. */
+export type ModuleDestination<D extends ModuleDescriptor = ModuleDescriptor> = D extends ModuleDescriptor ? {
+    readonly module: D["id"];
+    readonly page: D["pages"][number]["id"];
+} : never;
+/** Compare complete registrations across separate bundles without relying on object identity. */
+export declare const moduleRegistryFingerprint: (descriptors: ReadonlyArray<ModuleDescriptor>) => string;
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAKvC,eAAO,MAAM,cAAc,4EAAoE,CAAA;AAC/F,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB;;;;;;;QAOzB,sGAAsG;;;;;EAKxG,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;;;;;AAE3D,qBAAa,uBAAwB,SAAQ,4BAY3C;CAAG;AAEL,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,UAC1B,aAAa,CAAC,gBAAgB,CAAC,KACrC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAuBxE,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,YAAY,GAAI,KAAK,CAAC,CAAC,SAAS,gBAAgB,cAAc,CAAC,KAAG,CAAe,CAAA;AAE9F,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,CAAC,SAAS,gBAAgB,GACrG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;CAAE,GACrE,KAAK,CAAA;AAET,iGAAiG;AACjG,eAAO,MAAM,yBAAyB,gBAAiB,aAAa,CAAC,gBAAgB,CAAC,KAAG,MAUtF,CAAA"}

package/dist/module.js

@@ -0,0 +1,70 @@
+/** Module metadata shared by the hub shell, its core modules and every app. Moved from herdr-hub. @module */
+import { Result, Schema } from "effect";
+const Segment = Schema.String.check(Schema.isPattern(/^[a-z][a-z0-9-]*$/));
+const Label = Schema.String.check(Schema.isMinLength(1));
+export const ModuleListener = Schema.Literals(["serve", "local", "approval", "tailnet", "lan"]);
+/** Shared metadata. `requires` describes UI capabilities; the server mount enforces access. */
+export const ModuleDescriptor = Schema.Struct({
+    id: Segment,
+    label: Label,
+    defaultPage: Segment,
+    pages: Schema.Array(Schema.Struct({
+        id: Segment,
+        label: Label,
+        /** @deprecated Ignored: the phone header shows the product name and the breadcrumb names the page. */
+        showInPhoneTitle: Schema.optionalKey(Schema.Boolean)
+    })).check(Schema.isMinLength(1)),
+    listeners: Schema.Array(ModuleListener).check(Schema.isMinLength(1)),
+    requires: Schema.Array(Schema.Literals(["read", "write"]))
+});
+export class ModuleRegistrationError extends Schema.TaggedError()("ModuleRegistrationError", {
+    module: Schema.String,
+    reason: Schema.Literals([
+        "invalid_descriptor",
+        "duplicate_module",
+        "duplicate_page",
+        "missing_default",
+        "server_mismatch",
+        "browser_mismatch",
+        "invalid_route",
+        "duplicate_route"
+    ])
+}) {
+}
+/** Reject ambiguous namespaces and missing pages before a browser or server registry is used. */
+export const validateModuleRegistry = (input) => {
+    const decoded = Schema.decodeUnknownResult(Schema.Array(ModuleDescriptor))(input);
+    if (Result.isFailure(decoded)) {
+        return Result.fail(new ModuleRegistrationError({ module: "registry", reason: "invalid_descriptor" }));
+    }
+    const modules = new Set();
+    for (const descriptor of decoded.success) {
+        if (modules.has(descriptor.id)) {
+            return Result.fail(new ModuleRegistrationError({ module: descriptor.id, reason: "duplicate_module" }));
+        }
+        modules.add(descriptor.id);
+        const pages = new Set();
+        for (const page of descriptor.pages) {
+            if (pages.has(page.id)) {
+                return Result.fail(new ModuleRegistrationError({ module: descriptor.id, reason: "duplicate_page" }));
+            }
+            pages.add(page.id);
+        }
+        if (!pages.has(descriptor.defaultPage)) {
+            return Result.fail(new ModuleRegistrationError({ module: descriptor.id, reason: "missing_default" }));
+        }
+    }
+    return Result.succeed(decoded.success);
+};
+/** Retains literal page identities. Registration validates this metadata before mounting it. */
+export const defineModule = (descriptor) => descriptor;
+/** Compare complete registrations across separate bundles without relying on object identity. */
+export const moduleRegistryFingerprint = (descriptors) => Schema.encodeSync(Schema.fromJsonString(Schema.Array(ModuleDescriptor)))(descriptors
+    .map((descriptor) => ({
+    ...descriptor,
+    pages: [...descriptor.pages].sort((a, b) => a.id.localeCompare(b.id)),
+    listeners: [...descriptor.listeners].sort(),
+    requires: [...descriptor.requires].sort()
+}))
+    .sort((a, b) => a.id.localeCompare(b.id)));
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"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"}

package/dist/node.d.ts

@@ -0,0 +1,50 @@
+import type { BrowserLaunch } from "@knpkv/browser-pairing/launch";
+import { Effect, FileSystem, Layer, Path, Result, Schema } from "effect";
+import type { ShellServices } from "./hub-client.js";
+import { type AppManifestInput, AppStartError } from "./manifest.js";
+import { ModuleHandlers } from "./route.js";
+/** What an app hands the runner. Handlers may use {@link ShellServices}; the runner provides it. */
+export interface AppServer<E, R> {
+    readonly manifest: AppManifestInput;
+    readonly handlers: Layer.Layer<ModuleHandlers, E, R | ShellServices>;
+    readonly badge?: Effect.Effect<{
+        readonly text: string;
+        readonly label: string;
+    } | null, never, ShellServices>;
+    /** The built client: a directory holding `client.js` and, optionally, `client.css`. */
+    readonly clientDirectory: string;
+}
+export declare const RunMode: Schema.Union<readonly [Schema.TaggedStruct<"Attached", {
+    readonly socket: Schema.String;
+    readonly hubUrl: Schema.String;
+    readonly tokenFile: Schema.String;
+}>, Schema.TaggedStruct<"Standalone", {
+    readonly port: Schema.Int;
+    readonly open: Schema.Boolean;
+}>]>;
+export type RunMode = typeof RunMode.Type;
+/** Read the mode from argv and environment. `--socket` means attached; anything else is standalone. */
+export declare const readRunMode: (manifest: AppManifestInput, argv: ReadonlyArray<string>, env: Readonly<Record<string, string | undefined>>) => Result.Result<RunMode, AppStartError>;
+/** Attached mode alone: what the hub and its tests run. Needs no browser opener. */
+export declare const serveAttached: <E, R>(app: AppServer<E, R>, mode: {
+    readonly _tag: "Attached";
+    readonly socket: string;
+    readonly hubUrl: string;
+    readonly tokenFile: string;
+}) => Effect.Effect<never, AppStartError | import("effect/PlatformError").PlatformError | import("effect/http/HttpServerError").ServeError, FileSystem.FileSystem | import("effect/http/HttpClient").HttpClient | Path.Path | import("effect/Scope").Scope | Exclude<R, ShellServices>>;
+/**
+ * Serve the app in `mode` until interrupted. `launch` says whether standalone mode opens a browser for its
+ * sign-in link; the executable decides it from its terminal and environment.
+ */
+export declare const serveApp: <E, R>(app: AppServer<E, R>, mode: {
+    readonly _tag: "Attached";
+    readonly socket: string;
+    readonly hubUrl: string;
+    readonly tokenFile: string;
+} | {
+    readonly _tag: "Standalone";
+    readonly port: number;
+    readonly open: boolean;
+}, launch: BrowserLaunch) => Effect.Effect<void, AppStartError, import("@knpkv/browser-pairing/launch").BrowserOpener | import("effect/Crypto").Crypto | FileSystem.FileSystem | import("effect/http/HttpClient").HttpClient | Path.Path | import("effect/Scope").Scope | import("effect/Stdio").Stdio | Exclude<R, ShellServices>>;
+export { runApp } from "./main.js";
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAA4B,MAAM,+BAA+B,CAAA;AAG5F,OAAO,EAAqB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAU,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAanG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAe,KAAK,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAEjF,OAAO,EAML,cAAc,EAGf,MAAM,YAAY,CAAA;AAInB,oGAAoG;AACpG,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,CAAA;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,CAAA;IAC9G,uFAAuF;IACvF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC;AAED,eAAO,MAAM,OAAO;;;;;;;IAOlB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAEzC,uGAAuG;AACvG,eAAO,MAAM,WAAW,aACZ,gBAAgB,QACpB,aAAa,CAAC,MAAM,CAAC,OACtB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,KAChD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAiCtC,CAAA;AAsJD,oFAAoF;AACpF,eAAO,MAAM,aAAa,GAA+C,CAAC,EAAE,CAAC;;;;;uRAwC3E,CAAA;AAmGF;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAA0C,CAAC,EAAE,CAAC;;;;;;;;;mUAMoD,CAAA;AAEvH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA"}