@holo-js/broadcast 0.1.3

package/dist/runtime.d.ts

@@ -0,0 +1,91 @@
+import { BroadcastDefinition, BroadcastDefinitionInput, PendingBroadcastDispatch, BroadcastSendResult, RawBroadcastSendInput, ResolvedRawBroadcastSendInput, BroadcastDelayValue, BroadcastDriver, BroadcastRuntimeBindings, BroadcastRuntimeFacade } from './contracts.js';
+import '@holo-js/config';
+import '@holo-js/validation';
+
+type MutableDispatchOptions = {
+    broadcaster?: string;
+    connection?: string;
+    queue?: string;
+    delay?: BroadcastDelayValue;
+    afterCommit?: boolean;
+};
+type ResolvedQueuePlan = {
+    readonly queued: boolean;
+    readonly connection?: string;
+    readonly queue?: string;
+    readonly delay?: BroadcastDelayValue;
+    readonly afterCommit: boolean;
+};
+type ResolvedBroadcastConnection = {
+    readonly name: string;
+    readonly driver: string;
+};
+type ResolvedDriver = {
+    readonly connection: ResolvedBroadcastConnection;
+    readonly driver: string;
+    readonly implementation: BroadcastDriver;
+};
+type QueueDispatchChain = {
+    onConnection(name: string): QueueDispatchChain;
+    onQueue(name: string): QueueDispatchChain;
+    delay(value: number | Date): QueueDispatchChain;
+    dispatch(): Promise<unknown>;
+};
+type QueueModule = {
+    defineJob(definition: {
+        handle(payload: QueuedBroadcastPayload): Promise<unknown> | unknown;
+    }): unknown;
+    dispatch(jobName: string, payload: QueuedBroadcastPayload): QueueDispatchChain;
+    getRegisteredQueueJob(name: string): unknown;
+    registerQueueJob(definition: unknown, options: {
+        name: string;
+    }): void;
+};
+type DbModule = {
+    connectionAsyncContext: {
+        getActive(): {
+            connection: {
+                getScope(): {
+                    kind: string;
+                };
+                afterCommit(callback: () => Promise<void>): void;
+            };
+        } | undefined;
+    };
+};
+type QueuedBroadcastPayload = Readonly<{
+    readonly messageId: string;
+    readonly raw: ResolvedRawBroadcastSendInput;
+    readonly context: Readonly<{
+        readonly connection: string;
+        readonly driver: string;
+    }>;
+}>;
+declare function normalizeDelayValue(value: BroadcastDelayValue, label: string): BroadcastDelayValue;
+declare function resolveBroadcastConnection(selectedConnection: string | undefined): ResolvedBroadcastConnection;
+declare function normalizeRawBroadcastInput(input: RawBroadcastSendInput, selectedConnection?: string): Readonly<ResolvedRawBroadcastSendInput>;
+declare function createRawInputFromDefinition(definition: BroadcastDefinition, selectedConnection?: string): Readonly<ResolvedRawBroadcastSendInput>;
+declare function resolveQueuePlan(definition: BroadcastDefinition | null, options: Readonly<MutableDispatchOptions>): ResolvedQueuePlan;
+declare function resolveDriver(connectionName: string): ResolvedDriver;
+declare function ensureBroadcastQueueJobRegistered(queueModule?: QueueModule): Promise<QueueModule>;
+declare function configureBroadcastRuntime(bindings?: BroadcastRuntimeBindings): void;
+declare function getBroadcastRuntimeBindings(): BroadcastRuntimeBindings;
+declare function resetBroadcastRuntime(): void;
+declare function broadcast(definition: BroadcastDefinition | BroadcastDefinitionInput): PendingBroadcastDispatch<BroadcastSendResult>;
+declare function broadcastRaw(input: RawBroadcastSendInput): PendingBroadcastDispatch<BroadcastSendResult>;
+declare function getBroadcastRuntime(): BroadcastRuntimeFacade;
+declare const broadcastRuntimeInternals: {
+    createRawInputFromDefinition: typeof createRawInputFromDefinition;
+    ensureBroadcastQueueJobRegistered: typeof ensureBroadcastQueueJobRegistered;
+    normalizeDelayValue: typeof normalizeDelayValue;
+    normalizeRawBroadcastInput: typeof normalizeRawBroadcastInput;
+    resolveBroadcastConnection: typeof resolveBroadcastConnection;
+    resolveDriver: typeof resolveDriver;
+    resolveQueuePlan: typeof resolveQueuePlan;
+    resetBroadcastRuntime: typeof resetBroadcastRuntime;
+    runQueuedBroadcastDelivery(payload: QueuedBroadcastPayload): Promise<Readonly<BroadcastSendResult>>;
+    setLoadDbModuleForTesting(loader?: () => Promise<DbModule | null>): void;
+    setLoadQueueModuleForTesting(loader?: () => Promise<QueueModule>): void;
+};
+
+export { broadcast, broadcastRaw, broadcastRuntimeInternals, configureBroadcastRuntime, getBroadcastRuntime, getBroadcastRuntimeBindings, resetBroadcastRuntime };

package/dist/runtime.mjs

@@ -0,0 +1,19 @@
+import {
+  broadcast,
+  broadcastRaw,
+  broadcastRuntimeInternals,
+  configureBroadcastRuntime,
+  getBroadcastRuntime,
+  getBroadcastRuntimeBindings,
+  resetBroadcastRuntime
+} from "./chunk-742LGR5P.mjs";
+import "./chunk-QW6MHEWS.mjs";
+export {
+  broadcast,
+  broadcastRaw,
+  broadcastRuntimeInternals,
+  configureBroadcastRuntime,
+  getBroadcastRuntime,
+  getBroadcastRuntimeBindings,
+  resetBroadcastRuntime
+};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@holo-js/broadcast",
+  "version": "0.1.3",
+  "description": "Holo-JS Framework - broadcast contracts, channel definitions, and driver registration seams",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.mjs",
+      "default": "./dist/auth.mjs"
+    },
+    "./contracts": {
+      "types": "./dist/contracts.d.ts",
+      "import": "./dist/contracts.mjs",
+      "default": "./dist/contracts.mjs"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.mjs",
+      "default": "./dist/runtime.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "stub": "tsup",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest --run"
+  },
+  "dependencies": {
+    "@holo-js/config": "^0.1.3",
+    "@holo-js/validation": "^0.1.3",
+    "ws": "^8.18.3"
+  },
+  "peerDependencies": {
+    "ioredis": "catalog:"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/ws": "^8.18.1",
+    "ioredis": "catalog:",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}