adispatchd 0.0.0-stage → 0.1.0

package/dist/config/normalize.js

@@ -0,0 +1,200 @@
+/**
+ * Conversion of parsed YAML (snake_case, see `schemas.ts`) into the
+ * normalized model (`model.ts`). Pure; semantic checks live in `validate.ts`.
+ */
+import path from 'node:path';
+import { dataPaths, HOOK_NAMES } from '../core/index.js';
+/** Resolve a configured directory: absolute stays, relative is taken relative to the config dir. */
+export function resolveConfigPath(configDir, value) {
+    return path.resolve(configDir, value);
+}
+/**
+ * Resolve a configured command: absolute paths are normalized, relative paths
+ * containing `/` (e.g. `scripts/coder.sh`, `./x.sh`) are resolved against the
+ * config dir, bare names (e.g. `bash`) stay untouched for PATH lookup.
+ */
+export function resolveCommand(configDir, command) {
+    if (path.isAbsolute(command))
+        return path.normalize(command);
+    return command.includes('/') ? resolveConfigPath(configDir, command) : command;
+}
+/** Normalize `config.yaml`. */
+export function normalizeGlobal(raw, configDir, dataDir) {
+    const baseDir = raw.workspace.base_dir
+        ? resolveConfigPath(configDir, raw.workspace.base_dir)
+        : dataPaths(dataDir).defaultWorkspacesDir;
+    return {
+        server: { host: raw.server.host, port: raw.server.port, allowedHosts: raw.server.allowed_hosts.map((h) => h.toLowerCase()) },
+        scheduler: {
+            pollingIntervalMs: raw.scheduler.polling_interval,
+            maxConcurrent: raw.scheduler.max_concurrent,
+        },
+        workspace: { baseDir, cleanup: raw.workspace.cleanup },
+        lifecycle: {
+            actionRetry: {
+                maxAttempts: raw.lifecycle.action_retry.max_attempts,
+                delayMs: raw.lifecycle.action_retry.delay,
+            },
+        },
+        retention: {
+            completedRunsMs: raw.retention.completed_runs,
+            failedRunsMs: raw.retention.failed_runs,
+            blockedRunsMs: raw.retention.blocked_runs,
+            maxLogSizePerRunBytes: raw.retention.max_log_size_per_run,
+            cleanupIntervalMs: raw.retention.cleanup_interval,
+        },
+        notifications: {
+            on: [...raw.notifications.on],
+            channels: raw.notifications.channels.map((channel, index) => ({
+                id: channel.id ?? `channel-${index + 1}`,
+                type: channel.type,
+                url: channel.url ?? null,
+                urlEnv: channel.url_env ?? null,
+                headersEnv: { ...channel.headers_env },
+                on: [...(channel.on ?? raw.notifications.on)],
+            })),
+        },
+    };
+}
+/** Normalize `sources.yaml`. */
+export function normalizeSources(raw) {
+    const out = {};
+    for (const [id, source] of Object.entries(raw.sources)) {
+        out[id] = { id, type: source.type, owner: source.owner, repository: source.repository, identity: source.identity };
+    }
+    return out;
+}
+/** Normalize `identities.yaml`. */
+export function normalizeIdentities(raw) {
+    const out = {};
+    for (const [id, identity] of Object.entries(raw.identities)) {
+        out[id] = {
+            id,
+            type: identity.type,
+            appId: identity.app_id,
+            installationId: identity.installation_id,
+            privateKeyEnv: identity.private_key_env,
+        };
+    }
+    return out;
+}
+function normalizeParameter(raw) {
+    const base = { required: raw.required, description: raw.description ?? null };
+    // Defaults are type-checked in validate.ts; here they are only narrowed.
+    switch (raw.type) {
+        case 'string':
+            return { type: 'string', ...base, default: typeof raw.default === 'string' ? raw.default : null };
+        case 'number':
+            return { type: 'number', ...base, default: typeof raw.default === 'number' ? raw.default : null };
+        case 'boolean':
+            return { type: 'boolean', ...base, default: typeof raw.default === 'boolean' ? raw.default : null };
+        case 'enum':
+            return {
+                type: 'enum',
+                ...base,
+                values: [...raw.values],
+                default: typeof raw.default === 'string' && raw.values.includes(raw.default) ? raw.default : null,
+            };
+    }
+}
+function normalizeAction(raw, hook, index, defaults, configDir) {
+    const common = {
+        id: raw.id ?? `${hook}.${index}`,
+        continueOnError: raw.continue_on_error,
+        retry: {
+            maxAttempts: raw.retry?.max_attempts ?? defaults.maxAttempts,
+            delayMs: raw.retry?.delay ?? defaults.delayMs,
+        },
+    };
+    switch (raw.type) {
+        case 'source.update':
+            return { ...common, type: 'source.update', labels: { add: [...raw.labels.add], remove: [...raw.labels.remove] } };
+        case 'source.comment':
+            return { ...common, type: 'source.comment', message: raw.message, identity: raw.identity ?? null };
+        case 'shell':
+            return {
+                ...common,
+                type: 'shell',
+                command: resolveCommand(configDir, raw.command),
+                args: [...raw.args],
+                timeoutMs: raw.timeout,
+                env: { ...raw.env },
+            };
+    }
+}
+/** Normalize one workflow file. */
+export function normalizeWorkflow(raw, file, global, configDir) {
+    const hooks = Object.fromEntries(HOOK_NAMES.map((hook) => [
+        hook,
+        raw[hook].map((action, i) => normalizeAction(action, hook, i, global.lifecycle.actionRetry, configDir)),
+    ]));
+    const parameters = {};
+    for (const [name, def] of Object.entries(raw.parameters))
+        parameters[name] = normalizeParameter(def);
+    const exec = raw.execute;
+    return {
+        id: raw.id,
+        name: raw.name ?? raw.id,
+        file,
+        enabled: raw.enabled,
+        priority: raw.priority,
+        maxConcurrent: raw.max_concurrent,
+        identity: raw.identity ?? null,
+        trigger: raw.trigger.type === 'schedule'
+            ? { type: 'schedule', cron: raw.trigger.cron, timezone: raw.trigger.timezone }
+            : raw.trigger.type === 'source'
+                ? { type: 'source', source: raw.trigger.source }
+                : { type: 'manual' },
+        filter: raw.filter ?? null,
+        shellFilter: raw.shell_filter ? { command: resolveCommand(configDir, raw.shell_filter.command), timeoutMs: raw.shell_filter.timeout } : null,
+        itemPriority: raw.item_priority
+            ? { rules: raw.item_priority.rules.map((r) => ({ when: r.when, value: r.value })), default: raw.item_priority.default }
+            : null,
+        conditions: {
+            workflow: raw.conditions.workflow.map((c) => ({
+                type: c.type,
+                command: resolveCommand(configDir, c.command),
+                args: [...c.args],
+                timeoutMs: c.timeout,
+                cacheMs: c.cache ?? null,
+            })),
+            item: raw.conditions.item.map((c) => ({
+                type: c.type,
+                command: resolveCommand(configDir, c.command),
+                args: [...c.args],
+                timeoutMs: c.timeout,
+                cacheMs: c.cache ?? null,
+            })),
+        },
+        parameters,
+        execute: {
+            type: exec.type,
+            command: resolveCommand(configDir, exec.command),
+            args: [...exec.args],
+            workingDirectory: exec.working_directory,
+            createDirectory: exec.create_directory,
+            env: { ...exec.env },
+            secrets: Object.fromEntries(Object.entries(exec.secrets).map(([k, v]) => [k, { identity: v.identity }])),
+            timeout: {
+                maxDurationMs: exec.timeout.max_duration ?? null,
+                idleTimeoutMs: exec.timeout.idle_timeout ?? null,
+            },
+            cancelGraceMs: exec.cancel_grace,
+        },
+        retry: { maxTechnicalFailures: raw.retry.max_technical_failures },
+        hooks,
+    };
+}
+/** Normalize one view file. */
+export function normalizeView(raw, file) {
+    return {
+        id: raw.id,
+        title: raw.title ?? raw.id,
+        file,
+        sources: [...raw.sources],
+        filter: raw.filter ?? null,
+        fields: raw.fields.map((f) => ({ field: f.field, label: f.label ?? f.field, link: f.link ?? null })),
+        sort: raw.sort ? { field: raw.sort.field, direction: raw.sort.direction } : null,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/config/normalize.js.map

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

package/dist/config/parameters.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Validation of manual-start parameters against a workflow's declared
+ * parameter schema (Spec §5.5): checked before the start, defaults applied,
+ * unknown parameters rejected.
+ */
+import type { ParameterDefinition, ParameterValue, WorkflowConfig } from './model.js';
+/** One problem with a supplied parameter. */
+export interface ParameterIssue {
+    parameter: string;
+    message: string;
+}
+/** Result of {@link validateParameters}. */
+export type ParameterValidationResult = {
+    ok: true;
+    values: Record<string, ParameterValue>;
+} | {
+    ok: false;
+    errors: ParameterIssue[];
+};
+/**
+ * Validate `input` against `definitions`.
+ *
+ * Accepted input: values of the declared type; additionally numeric strings
+ * for `number` and `"true"`/`"false"` for `boolean` (HTML form input).
+ * Missing optional parameters get their default (or are omitted); missing
+ * required parameters without default are errors.
+ */
+export declare function validateParameters(definitions: Readonly<Record<string, ParameterDefinition>>, input: Readonly<Record<string, unknown>> | undefined): ParameterValidationResult;
+/**
+ * Parameter values of an automatically started run (source / cron trigger):
+ * the declared defaults. Parameters without default are omitted (validation
+ * guarantees that automatic workflows have no required parameter without one).
+ * `null` if there is nothing to set.
+ */
+export declare function automaticParameterValues(workflow: Pick<WorkflowConfig, 'parameters'>): Record<string, ParameterValue> | null;
+/** Shorthand for {@link validateParameters} with a workflow. */
+export declare function validateWorkflowParameters(workflow: Pick<WorkflowConfig, 'parameters'>, input: Readonly<Record<string, unknown>> | undefined): ParameterValidationResult;

package/dist/config/parameters.js

@@ -0,0 +1,71 @@
+/**
+ * Validate `input` against `definitions`.
+ *
+ * Accepted input: values of the declared type; additionally numeric strings
+ * for `number` and `"true"`/`"false"` for `boolean` (HTML form input).
+ * Missing optional parameters get their default (or are omitted); missing
+ * required parameters without default are errors.
+ */
+export function validateParameters(definitions, input) {
+    const errors = [];
+    const values = {};
+    const supplied = input ?? {};
+    for (const name of Object.keys(supplied)) {
+        if (!Object.hasOwn(definitions, name))
+            errors.push({ parameter: name, message: 'Unknown parameter' });
+    }
+    for (const [name, def] of Object.entries(definitions)) {
+        const raw = Object.hasOwn(supplied, name) ? supplied[name] : undefined;
+        if (raw === undefined || raw === null || raw === '') {
+            if (def.default !== null)
+                values[name] = def.default;
+            else if (def.required)
+                errors.push({ parameter: name, message: 'Required parameter is missing' });
+            continue;
+        }
+        const coerced = coerce(def, raw);
+        if (coerced.ok)
+            values[name] = coerced.value;
+        else
+            errors.push({ parameter: name, message: coerced.message });
+    }
+    return errors.length > 0 ? { ok: false, errors } : { ok: true, values };
+}
+/**
+ * Parameter values of an automatically started run (source / cron trigger):
+ * the declared defaults. Parameters without default are omitted (validation
+ * guarantees that automatic workflows have no required parameter without one).
+ * `null` if there is nothing to set.
+ */
+export function automaticParameterValues(workflow) {
+    const values = {};
+    for (const [name, def] of Object.entries(workflow.parameters))
+        if (def.default !== null)
+            values[name] = def.default;
+    return Object.keys(values).length > 0 ? values : null;
+}
+/** Shorthand for {@link validateParameters} with a workflow. */
+export function validateWorkflowParameters(workflow, input) {
+    return validateParameters(workflow.parameters, input);
+}
+function coerce(def, raw) {
+    switch (def.type) {
+        case 'string':
+            return typeof raw === 'string' ? { ok: true, value: raw } : { ok: false, message: 'Expected a string' };
+        case 'number': {
+            const n = typeof raw === 'number' ? raw : typeof raw === 'string' && raw.trim() !== '' ? Number(raw) : NaN;
+            return Number.isFinite(n) ? { ok: true, value: n } : { ok: false, message: 'Expected a number' };
+        }
+        case 'boolean':
+            if (typeof raw === 'boolean')
+                return { ok: true, value: raw };
+            if (raw === 'true' || raw === 'false')
+                return { ok: true, value: raw === 'true' };
+            return { ok: false, message: 'Expected a boolean' };
+        case 'enum':
+            return typeof raw === 'string' && def.values.includes(raw)
+                ? { ok: true, value: raw }
+                : { ok: false, message: `Expected one of: ${def.values.join(', ')}` };
+    }
+}
+//# sourceMappingURL=parameters.js.map

package/dist/config/parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.js","sourceRoot":"","sources":["../../src/config/parameters.ts"],"names":[],"mappings":"AAkBA;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAA0D,EAC1D,KAAoD;IAEpD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;YACpD,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;iBAChD,IAAI,GAAG,CAAC,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC,CAAC;YAClG,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;;YACxC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA4C;IAE5C,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;IACpH,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,0BAA0B,CACxC,QAA4C,EAC5C,KAAoD;IAEpD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,MAAM,CACb,GAAwB,EACxB,GAAY;IAEZ,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;QAC1G,KAAK,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC3G,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;QACnG,CAAC;QACD,KAAK,SAAS;YACZ,IAAI,OAAO,GAAG,KAAK,SAAS;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YAC9D,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,MAAM,EAAE,CAAC;YAClF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;QACtD,KAAK,MAAM;YACT,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;gBACxD,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;gBAC1B,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/config/public.d.ts

@@ -0,0 +1,6 @@
+import type { LoadedConfig } from './model.js';
+/**
+ * Deep copy of `config` that is safe to expose: literal notification URLs are
+ * replaced by `[REDACTED]`. Environment variable *names* stay visible.
+ */
+export declare function toPublicConfig(config: LoadedConfig): LoadedConfig;

package/dist/config/public.js

@@ -0,0 +1,18 @@
+/**
+ * Redacted view of the configuration for API responses, logs and the CLI
+ * (Spec §18, §20.4): literal webhook URLs may embed tokens and are masked.
+ */
+import { REDACTED } from '../core/index.js';
+/**
+ * Deep copy of `config` that is safe to expose: literal notification URLs are
+ * replaced by `[REDACTED]`. Environment variable *names* stay visible.
+ */
+export function toPublicConfig(config) {
+    const copy = JSON.parse(JSON.stringify(config));
+    const channels = copy.global.notifications.channels.map((channel) => ({
+        ...channel,
+        url: channel.url === null ? null : REDACTED,
+    }));
+    return { ...copy, global: { ...copy.global, notifications: { ...copy.global.notifications, channels } } };
+}
+//# sourceMappingURL=public.js.map

package/dist/config/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../src/config/public.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAiB,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACpE,GAAG,OAAO;QACV,GAAG,EAAE,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;KAC5C,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC5G,CAAC"}