@vizamodo/modo-dispatcher 1.1.77

package/dist/types/dispatcher.js

@@ -0,0 +1 @@
+export {};

package/dist/types/payload.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Opaque payload forwarded to GitHub Actions.
+ * Dispatcher MUST NOT inspect its structure.
+ */
+export type DispatchPayload = unknown;

package/dist/types/payload.js

@@ -0,0 +1,2 @@
+// types/payload.ts
+export {};

package/dist/types/runtime-env.d.ts

@@ -0,0 +1,2 @@
+export type RuntimeEnv = "dev" | "prod";
+export declare function assertRuntimeEnv(env: string): asserts env is RuntimeEnv;

package/dist/types/runtime-env.js

@@ -0,0 +1,5 @@
+export function assertRuntimeEnv(env) {
+    if (env !== "dev" && env !== "prod") {
+        throw new Error(`\nInvalid runtime env: ${env}. Expected 'dev' or 'prod'`);
+    }
+}

package/dist/ui/banner.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Render a compact dispatch banner showing the acting user and team.
+ */
+export declare function renderDispatchBanner(login: string, teams: string[], allowedTeams: string[] | undefined, isStatusMode: boolean): void;

package/dist/ui/banner.js

@@ -0,0 +1,20 @@
+import chalk from "chalk";
+/**
+ * Render a compact dispatch banner showing the acting user and team.
+ */
+export function renderDispatchBanner(login, teams, allowedTeams, isStatusMode) {
+    const action = isStatusMode ? "checking status" : "dispatching";
+    // Choose a single representative team to show to the user.
+    // Prefer an intersection with `allowedTeams` (if provided),
+    // otherwise fall back to the first JWT team.
+    let representative;
+    if (Array.isArray(allowedTeams) && allowedTeams.length > 0) {
+        const intersection = teams.filter((t) => allowedTeams.includes(t));
+        if (intersection.length > 0)
+            representative = intersection[0];
+    }
+    if (!representative && teams.length > 0)
+        representative = teams[0];
+    const display = representative ?? "unknown";
+    console.log(`\n[${login}] ${chalk.gray(`is ${action} as`)} ${display} …`);
+}

package/dist/utils/request-dedup.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Request deduplication utility for preventing concurrent identical requests.
+ *
+ * Multiple modules were implementing their own in-flight request tracking.
+ * This provides a reusable, type-safe solution.
+ *
+ * @module utils/request-dedup
+ */
+/**
+ * Request deduplicator that prevents concurrent identical requests.
+ *
+ * When multiple callers request the same operation simultaneously,
+ * only one actual operation is performed and all callers receive the same result.
+ *
+ * @example
+ * ```typescript
+ * const authDeduplicator = new RequestDeduplicator<void>();
+ *
+ * async function ensureAuthenticated(): Promise<void> {
+ *   return authDeduplicator.dedupe('auth', async () => {
+ *     // Expensive authentication logic runs only once
+ *     await performAuth();
+ *   });
+ * }
+ * ```
+ */
+export declare class RequestDeduplicator<T> {
+    private inFlight;
+    /**
+     * Execute a function with deduplication.
+     *
+     * If a request with the same key is already in flight, returns the existing promise.
+     * Otherwise, executes the function and caches the result until completion.
+     *
+     * @param key - Unique identifier for this type of request
+     * @param fn - Async function to execute
+     * @returns Promise that resolves when the operation completes
+     */
+    dedupe(key: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Check if a request with the given key is currently in flight.
+     */
+    has(key: string): boolean;
+    /**
+     * Get the in-flight promise for a key, if any.
+     */
+    get(key: string): Promise<T> | undefined;
+    /**
+     * Clear a specific key or all in-flight requests.
+     *
+     * @param key - Optional key to clear. If omitted, clears all.
+     */
+    clear(key?: string): void;
+    /**
+     * Get the number of in-flight requests.
+     */
+    get size(): number;
+}
+/**
+ * Global deduplicators for common operations.
+ * These are shared across the application.
+ */
+export declare const globalDeduplicators: {
+    /** Authentication flow deduplicator */
+    readonly auth: RequestDeduplicator<void>;
+    /** Token hydration deduplicator */
+    readonly hydration: RequestDeduplicator<void>;
+    /** Token refresh deduplicator */
+    readonly refresh: RequestDeduplicator<string>;
+};
+/**
+ * Reset all global deduplicators.
+ * Useful for testing.
+ */
+export declare function resetGlobalDeduplicators(): void;

package/dist/utils/request-dedup.js

@@ -0,0 +1,102 @@
+/**
+ * Request deduplication utility for preventing concurrent identical requests.
+ *
+ * Multiple modules were implementing their own in-flight request tracking.
+ * This provides a reusable, type-safe solution.
+ *
+ * @module utils/request-dedup
+ */
+/**
+ * Request deduplicator that prevents concurrent identical requests.
+ *
+ * When multiple callers request the same operation simultaneously,
+ * only one actual operation is performed and all callers receive the same result.
+ *
+ * @example
+ * ```typescript
+ * const authDeduplicator = new RequestDeduplicator<void>();
+ *
+ * async function ensureAuthenticated(): Promise<void> {
+ *   return authDeduplicator.dedupe('auth', async () => {
+ *     // Expensive authentication logic runs only once
+ *     await performAuth();
+ *   });
+ * }
+ * ```
+ */
+export class RequestDeduplicator {
+    inFlight = new Map();
+    /**
+     * Execute a function with deduplication.
+     *
+     * If a request with the same key is already in flight, returns the existing promise.
+     * Otherwise, executes the function and caches the result until completion.
+     *
+     * @param key - Unique identifier for this type of request
+     * @param fn - Async function to execute
+     * @returns Promise that resolves when the operation completes
+     */
+    async dedupe(key, fn) {
+        const existing = this.inFlight.get(key);
+        if (existing) {
+            return existing;
+        }
+        const promise = fn().finally(() => {
+            this.inFlight.delete(key);
+        });
+        this.inFlight.set(key, promise);
+        return promise;
+    }
+    /**
+     * Check if a request with the given key is currently in flight.
+     */
+    has(key) {
+        return this.inFlight.has(key);
+    }
+    /**
+     * Get the in-flight promise for a key, if any.
+     */
+    get(key) {
+        return this.inFlight.get(key);
+    }
+    /**
+     * Clear a specific key or all in-flight requests.
+     *
+     * @param key - Optional key to clear. If omitted, clears all.
+     */
+    clear(key) {
+        if (key) {
+            this.inFlight.delete(key);
+        }
+        else {
+            this.inFlight.clear();
+        }
+    }
+    /**
+     * Get the number of in-flight requests.
+     */
+    get size() {
+        return this.inFlight.size;
+    }
+}
+/**
+ * Global deduplicators for common operations.
+ * These are shared across the application.
+ */
+export const globalDeduplicators = {
+    /** Authentication flow deduplicator */
+    auth: new RequestDeduplicator(),
+    /** Token hydration deduplicator */
+    hydration: new RequestDeduplicator(),
+    /** Token refresh deduplicator */
+    refresh: new RequestDeduplicator(),
+};
+/**
+ * Reset all global deduplicators.
+ * Useful for testing.
+ */
+export function resetGlobalDeduplicators() {
+    globalDeduplicators.auth.clear();
+    globalDeduplicators.hydration.clear();
+    globalDeduplicators.refresh.clear();
+}

package/dist/utils/type-guards.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Type guard utilities for runtime type checking.
+ *
+ * These functions provide type-safe alternatives to `as any` casts.
+ * All functions follow the TypeScript type guard pattern: `obj is T`.
+ *
+ * @module utils/type-guards
+ */
+/**
+ * Check if a value is a non-null object.
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if a value is a string.
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Check if a value is a non-empty string.
+ */
+export declare function isNonEmptyString(value: unknown): value is string;
+/**
+ * Check if a value is a number.
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Check if a value is a boolean.
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Check if a value is an array.
+ */
+export declare function isArray(value: unknown): value is unknown[];
+/**
+ * Check if a value is an array of strings.
+ */
+export declare function isStringArray(value: unknown): value is string[];
+/**
+ * Check if an object has a specific string property.
+ */
+export declare function hasStringProperty<K extends string>(obj: unknown, key: K): obj is Record<K, string>;
+/**
+ * Check if an object has a specific number property.
+ */
+export declare function hasNumberProperty<K extends string>(obj: unknown, key: K): obj is Record<K, number>;
+/**
+ * Check if an object has a specific optional string property.
+ */
+export declare function hasOptionalStringProperty<K extends string>(obj: unknown, key: K): obj is Record<K, string | undefined>;
+/**
+ * Check if an object has a sessionId property.
+ */
+export declare function hasSessionId(obj: unknown): obj is {
+    sessionId: string;
+};
+/**
+ * Check if an object has an executionKey property.
+ */
+export declare function hasExecutionKey(obj: unknown): obj is {
+    executionKey: string;
+};
+/**
+ * Check if an object has a wsToken property.
+ */
+export declare function hasWsToken(obj: unknown): obj is {
+    wsToken: string;
+};
+/**
+ * Check if an object has a wsUrl property.
+ */
+export declare function hasWsUrl(obj: unknown): obj is {
+    wsUrl: string;
+};
+/**
+ * Check if an object has a downloadUrl property.
+ */
+export declare function hasDownloadUrl(obj: unknown): obj is {
+    downloadUrl: string;
+};
+/**
+ * Check if an object has a path property.
+ */
+export declare function hasPath(obj: unknown): obj is {
+    path: string;
+};
+/**
+ * Check if an object has a message property.
+ */
+export declare function hasMessage(obj: unknown): obj is {
+    message: string;
+};
+/**
+ * Check if an object has a stack property.
+ */
+export declare function hasStack(obj: unknown): obj is {
+    stack: string;
+};
+/**
+ * Check if an object has a type property with specific value.
+ */
+export declare function hasType<T extends string>(obj: unknown, expectedType: T): obj is {
+    type: T;
+};
+/**
+ * Check if an object has an action property with specific value.
+ */
+export declare function hasAction<T extends string>(obj: unknown, expectedAction: T): obj is {
+    action: T;
+};
+/**
+ * Check if an object has a status property.
+ */
+export declare function hasStatus(obj: unknown): obj is {
+    status: string;
+};
+/**
+ * Check if an object has a conclusion property.
+ */
+export declare function hasConclusion(obj: unknown): obj is {
+    conclusion: string;
+};
+/**
+ * Safely extract a string property from an object.
+ * Returns undefined if the property doesn't exist or isn't a string.
+ */
+export declare function extractString<K extends string>(obj: unknown, key: K): string | undefined;
+/**
+ * Safely extract a number property from an object.
+ * Returns undefined if the property doesn't exist or isn't a number.
+ */
+export declare function extractNumber<K extends string>(obj: unknown, key: K): number | undefined;
+/**
+ * Safely extract an object property from an object.
+ * Returns undefined if the property doesn't exist or isn't an object.
+ */
+export declare function extractObject<K extends string>(obj: unknown, key: K): Record<string, unknown> | undefined;
+/**
+ * Safely extract an array property from an object.
+ * Returns undefined if the property doesn't exist or isn't an array.
+ */
+export declare function extractArray<K extends string>(obj: unknown, key: K): unknown[] | undefined;
+/**
+ * Extract session ID from various possible locations in an object.
+ * Checks sessionId first, then executionKey, then returns undefined.
+ */
+export declare function extractSessionId(obj: unknown): string | undefined;
+/**
+ * Extract error information from an unknown error.
+ * Returns a normalized error object with message and optional stack.
+ */
+export declare function extractErrorInfo(error: unknown): {
+    message: string;
+    stack?: string;
+} | undefined;
+/**
+ * Check if an object looks like a log artifact.
+ */
+export declare function isLogArtifactLike(obj: unknown): obj is {
+    path: string;
+    downloadUrl?: string;
+    status?: string;
+};
+/**
+ * Check if an object looks like a result artifact reference.
+ */
+export declare function isResultArtifactRef(obj: unknown): obj is {
+    downloadUrl: string;
+    path?: string;
+};
+/**
+ * Narrow an object to have specific required properties.
+ * Useful for validating gateway responses.
+ */
+export declare function hasRequiredProperties<T extends string>(obj: unknown, keys: readonly T[]): obj is Record<T, unknown>;

package/dist/utils/type-guards.js

@@ -0,0 +1,232 @@
+/**
+ * Type guard utilities for runtime type checking.
+ *
+ * These functions provide type-safe alternatives to `as any` casts.
+ * All functions follow the TypeScript type guard pattern: `obj is T`.
+ *
+ * @module utils/type-guards
+ */
+/**
+ * Check if a value is a non-null object.
+ */
+export function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Check if a value is a string.
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Check if a value is a non-empty string.
+ */
+export function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/**
+ * Check if a value is a number.
+ */
+export function isNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+/**
+ * Check if a value is a boolean.
+ */
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+/**
+ * Check if a value is an array.
+ */
+export function isArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * Check if a value is an array of strings.
+ */
+export function isStringArray(value) {
+    return Array.isArray(value) && value.every(isString);
+}
+/**
+ * Check if an object has a specific string property.
+ */
+export function hasStringProperty(obj, key) {
+    return isObject(obj) && typeof obj[key] === 'string';
+}
+/**
+ * Check if an object has a specific number property.
+ */
+export function hasNumberProperty(obj, key) {
+    return isObject(obj) && typeof obj[key] === 'number';
+}
+/**
+ * Check if an object has a specific optional string property.
+ */
+export function hasOptionalStringProperty(obj, key) {
+    return isObject(obj) && (obj[key] === undefined || typeof obj[key] === 'string');
+}
+/**
+ * Check if an object has a sessionId property.
+ */
+export function hasSessionId(obj) {
+    return hasStringProperty(obj, 'sessionId');
+}
+/**
+ * Check if an object has an executionKey property.
+ */
+export function hasExecutionKey(obj) {
+    return hasStringProperty(obj, 'executionKey');
+}
+/**
+ * Check if an object has a wsToken property.
+ */
+export function hasWsToken(obj) {
+    return hasStringProperty(obj, 'wsToken');
+}
+/**
+ * Check if an object has a wsUrl property.
+ */
+export function hasWsUrl(obj) {
+    return hasStringProperty(obj, 'wsUrl');
+}
+/**
+ * Check if an object has a downloadUrl property.
+ */
+export function hasDownloadUrl(obj) {
+    return hasStringProperty(obj, 'downloadUrl');
+}
+/**
+ * Check if an object has a path property.
+ */
+export function hasPath(obj) {
+    return hasStringProperty(obj, 'path');
+}
+/**
+ * Check if an object has a message property.
+ */
+export function hasMessage(obj) {
+    return hasStringProperty(obj, 'message');
+}
+/**
+ * Check if an object has a stack property.
+ */
+export function hasStack(obj) {
+    return hasStringProperty(obj, 'stack');
+}
+/**
+ * Check if an object has a type property with specific value.
+ */
+export function hasType(obj, expectedType) {
+    return isObject(obj) && obj['type'] === expectedType;
+}
+/**
+ * Check if an object has an action property with specific value.
+ */
+export function hasAction(obj, expectedAction) {
+    return isObject(obj) && obj['action'] === expectedAction;
+}
+/**
+ * Check if an object has a status property.
+ */
+export function hasStatus(obj) {
+    return hasStringProperty(obj, 'status');
+}
+/**
+ * Check if an object has a conclusion property.
+ */
+export function hasConclusion(obj) {
+    return hasStringProperty(obj, 'conclusion');
+}
+/**
+ * Safely extract a string property from an object.
+ * Returns undefined if the property doesn't exist or isn't a string.
+ */
+export function extractString(obj, key) {
+    if (!isObject(obj))
+        return undefined;
+    const value = obj[key];
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+}
+/**
+ * Safely extract a number property from an object.
+ * Returns undefined if the property doesn't exist or isn't a number.
+ */
+export function extractNumber(obj, key) {
+    if (!isObject(obj))
+        return undefined;
+    const value = obj[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * Safely extract an object property from an object.
+ * Returns undefined if the property doesn't exist or isn't an object.
+ */
+export function extractObject(obj, key) {
+    if (!isObject(obj))
+        return undefined;
+    const value = obj[key];
+    return isObject(value) ? value : undefined;
+}
+/**
+ * Safely extract an array property from an object.
+ * Returns undefined if the property doesn't exist or isn't an array.
+ */
+export function extractArray(obj, key) {
+    if (!isObject(obj))
+        return undefined;
+    const value = obj[key];
+    return Array.isArray(value) ? value : undefined;
+}
+/**
+ * Extract session ID from various possible locations in an object.
+ * Checks sessionId first, then executionKey, then returns undefined.
+ */
+export function extractSessionId(obj) {
+    if (!isObject(obj))
+        return undefined;
+    if (hasSessionId(obj)) {
+        return obj.sessionId;
+    }
+    if (hasExecutionKey(obj)) {
+        return obj.executionKey;
+    }
+    return undefined;
+}
+/**
+ * Extract error information from an unknown error.
+ * Returns a normalized error object with message and optional stack.
+ */
+export function extractErrorInfo(error) {
+    if (!isObject(error))
+        return undefined;
+    const message = extractString(error, 'message');
+    if (!message)
+        return undefined;
+    const stack = extractString(error, 'stack');
+    return {
+        message,
+        ...(stack ? { stack } : {}),
+    };
+}
+/**
+ * Check if an object looks like a log artifact.
+ */
+export function isLogArtifactLike(obj) {
+    return isObject(obj) && hasPath(obj);
+}
+/**
+ * Check if an object looks like a result artifact reference.
+ */
+export function isResultArtifactRef(obj) {
+    return isObject(obj) && hasDownloadUrl(obj);
+}
+/**
+ * Narrow an object to have specific required properties.
+ * Useful for validating gateway responses.
+ */
+export function hasRequiredProperties(obj, keys) {
+    if (!isObject(obj))
+        return false;
+    return keys.every(key => key in obj);
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@vizamodo/modo-dispatcher",
+  "version": "1.1.77",
+  "description": "Dispatcher module for GitHub workflow automation across Viza projects",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc && npm run copy:templates",
+    "copy:templates": "mkdir -p dist/auth/oauth/templates && cp src/auth/oauth/templates/*.html dist/auth/oauth/templates/",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "release:dev": "npm version prerelease --preid=dev && npm publish --tag dev --access public",
+    "release:beta": "npm version prerelease --preid=beta && npm publish --tag beta --access public",
+    "release:prod": "rm -rf dist && npx npm-check-updates -u && npm install && git add package.json package-lock.json && git commit -m 'chore(deps): auto update dependencies before release' || echo 'No changes' && node versioning.js && npm publish --tag latest --access public && git push",
+    "release:full": "rm -rf dist && npx npm-check-updates -u && npm install && git add package.json package-lock.json && git commit -m 'chore(deps): auto update dependencies before release' || echo 'No changes' && node versioning.js && npm login && npm publish --tag latest --access public && git push"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "author": "Viza Team",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@types/ws": "^8.18.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  },
+  "type": "module",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "ws": "^8.20.1"
+  }
+}