@allstak/wizard 0.1.3

package/dist/config/migrations.d.ts

@@ -0,0 +1,64 @@
+import { type WizardConfigInput, type WizardConfigSchemaVersion } from './types.js';
+/**
+ * Config-schema migration runner.
+ *
+ * Distinct from `src/migrations/` (which targets the user's INSTALL state —
+ * env vars, SDK versions). Config migrations only ever touch
+ * `allstak.config.*` content.
+ *
+ * Each migration takes a parsed config at version N and returns a config at
+ * version N+1. Migrations are pure functions — they MUST NOT throw on a
+ * conformant N-shaped input.
+ */
+export interface ConfigMigration {
+    /** From version N. */
+    from: WizardConfigSchemaVersion;
+    /** To version N+1. */
+    to: WizardConfigSchemaVersion;
+    /** Short description shown by `allstak config migrate --dry-run`. */
+    description: string;
+    /** Applies the migration. Should be idempotent: calling on already-migrated input must not corrupt. */
+    apply(input: WizardConfigInput): WizardConfigInput;
+    /** Optional deprecation warnings to surface to the user. */
+    warnings?: (input: WizardConfigInput) => string[];
+}
+/**
+ * Migration list. As of v0.1.3 the schema is at version 1; no forward
+ * migrations exist yet. The list is the ONLY place to add a new migration —
+ * the runner sorts by `from` and applies sequentially.
+ *
+ * Adding a v1→v2 migration:
+ *
+ *   ```ts
+ *   {
+ *     from: 1, to: 2,
+ *     description: 'rename `organization` to `org`',
+ *     apply: (cfg) => {
+ *       const next = { ...cfg, schemaVersion: 2 } as WizardConfigInput;
+ *       // ...transform...
+ *       return next;
+ *     },
+ *   }
+ *   ```
+ */
+export declare const CONFIG_MIGRATIONS: readonly ConfigMigration[];
+export interface MigrateResult {
+    /** Migrated config (at the current schema version). */
+    config: WizardConfigInput;
+    /** Migrations that were applied, in order. */
+    applied: {
+        id: string;
+        description: string;
+    }[];
+    /** Deprecation warnings emitted by migrations. */
+    warnings: string[];
+}
+/**
+ * Run all forward migrations needed to bring the config from its declared
+ * version up to `CURRENT_CONFIG_SCHEMA_VERSION`. Throws
+ * `E_CONFIG_MIGRATION_FAILED` if any individual migration fails.
+ */
+export declare function runConfigMigrations(input: WizardConfigInput): MigrateResult;
+/** Returns the highest schemaVersion that has a forward migration FROM. */
+export declare function highestKnownVersion(): WizardConfigSchemaVersion;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/config/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/config/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,iBAAiB,EAAE,KAAK,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAGnH;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,IAAI,EAAE,yBAAyB,CAAC;IAChC,sBAAsB;IACtB,EAAE,EAAE,yBAAyB,CAAC;IAC9B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,uGAAuG;IACvG,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IACnD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,MAAM,EAAE,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAEvD,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,kDAAkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,CA8C3E;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,IAAI,yBAAyB,CAE/D"}

package/dist/config/migrations.js

@@ -0,0 +1,66 @@
+import { CURRENT_CONFIG_SCHEMA_VERSION } from './types.js';
+import { WizardError } from '../util/errors.js';
+/**
+ * Migration list. As of v0.1.3 the schema is at version 1; no forward
+ * migrations exist yet. The list is the ONLY place to add a new migration —
+ * the runner sorts by `from` and applies sequentially.
+ *
+ * Adding a v1→v2 migration:
+ *
+ *   ```ts
+ *   {
+ *     from: 1, to: 2,
+ *     description: 'rename `organization` to `org`',
+ *     apply: (cfg) => {
+ *       const next = { ...cfg, schemaVersion: 2 } as WizardConfigInput;
+ *       // ...transform...
+ *       return next;
+ *     },
+ *   }
+ *   ```
+ */
+export const CONFIG_MIGRATIONS = [
+// No migrations registered as of v0.1.3.
+];
+/**
+ * Run all forward migrations needed to bring the config from its declared
+ * version up to `CURRENT_CONFIG_SCHEMA_VERSION`. Throws
+ * `E_CONFIG_MIGRATION_FAILED` if any individual migration fails.
+ */
+export function runConfigMigrations(input) {
+    const startVersion = (input.schemaVersion ?? 1);
+    if (startVersion > CURRENT_CONFIG_SCHEMA_VERSION) {
+        throw new WizardError('E_CONFIG_MIGRATION_FAILED', `Config declares schemaVersion=${startVersion}, but this wizard only knows up to ${CURRENT_CONFIG_SCHEMA_VERSION}.`, { subcode: 'E_CONFIG_FUTURE_VERSION', hint: 'Upgrade @allstak/wizard.' });
+    }
+    let current = { ...input, schemaVersion: startVersion };
+    const applied = [];
+    const warnings = [];
+    // Sort by `from` so a v1→v2→v3 chain runs in order, even if registered out of order.
+    const ordered = [...CONFIG_MIGRATIONS].sort((a, b) => a.from - b.from);
+    for (const m of ordered) {
+        if (current.schemaVersion !== m.from)
+            continue;
+        if (m.warnings)
+            warnings.push(...m.warnings(current));
+        try {
+            current = m.apply(current);
+        }
+        catch (err) {
+            throw new WizardError('E_CONFIG_MIGRATION_FAILED', `Migration ${m.from}→${m.to} ("${m.description}") failed: ${err instanceof Error ? err.message : String(err)}`, { subcode: 'E_MIGRATION_THREW', cause: err, context: { from: m.from, to: m.to } });
+        }
+        if (current.schemaVersion !== m.to) {
+            throw new WizardError('E_CONFIG_MIGRATION_FAILED', `Migration ${m.from}→${m.to} did not bump schemaVersion to ${m.to}.`, { subcode: 'E_MIGRATION_NO_BUMP', context: { from: m.from, to: m.to } });
+        }
+        applied.push({ id: `${m.from}->${m.to}`, description: m.description });
+    }
+    // Final assertion: we should be at the current version.
+    if (current.schemaVersion !== CURRENT_CONFIG_SCHEMA_VERSION) {
+        throw new WizardError('E_CONFIG_MIGRATION_FAILED', `Migration chain stopped at schemaVersion=${current.schemaVersion}, expected ${CURRENT_CONFIG_SCHEMA_VERSION}. Missing migration step?`, { subcode: 'E_MIGRATION_INCOMPLETE' });
+    }
+    return { config: current, applied, warnings };
+}
+/** Returns the highest schemaVersion that has a forward migration FROM. */
+export function highestKnownVersion() {
+    return CURRENT_CONFIG_SCHEMA_VERSION;
+}
+//# sourceMappingURL=migrations.js.map

package/dist/config/migrations.js.map

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

package/dist/config/precedence.d.ts

@@ -0,0 +1,24 @@
+import { type ResolvedWizardConfig, type WizardConfigInput } from './types.js';
+/**
+ * Apply precedence rules:
+ *
+ *   CLI flag  >  env var  >  config file  >  built-in default
+ *
+ * `cli` is the bag of flags `commander` parsed; pass `undefined` for any flag
+ * the user did not supply so we know to fall through. `env` defaults to
+ * `process.env` but is injectable for tests.
+ */
+export interface CliInputs {
+    organization?: string;
+    project?: string;
+    environment?: string;
+    release?: string;
+    apiHost?: string;
+    ingestHost?: string;
+    dashboardHost?: string;
+    snapshotKeep?: number;
+    /** When true the CLI explicitly opted out of source maps; never overridden by config. */
+    skipSourceMaps?: boolean;
+}
+export declare function resolveConfig(config: WizardConfigInput | null, cli: CliInputs, env?: Record<string, string | undefined>): ResolvedWizardConfig;
+//# sourceMappingURL=precedence.d.ts.map

package/dist/config/precedence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precedence.d.ts","sourceRoot":"","sources":["../../src/config/precedence.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AAEH,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAChC,GAAG,EAAE,SAAS,EACd,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,oBAAoB,CA2BtB"}

package/dist/config/precedence.js

@@ -0,0 +1,55 @@
+import { DEFAULT_API_HOST, DEFAULT_DASHBOARD_HOST, } from './types.js';
+export function resolveConfig(config, cli, env = process.env) {
+    const cfg = config ?? {};
+    const release = pick(cli.release, env.ALLSTAK_RELEASE, materialiseRelease(cfg.release), null);
+    const apiHost = pick(cli.apiHost, env.ALLSTAK_HOST, cfg.selfHosted?.apiHost, DEFAULT_API_HOST);
+    const ingestHost = pick(cli.ingestHost, env.ALLSTAK_INGEST_HOST, cfg.selfHosted?.ingestHost, apiHost);
+    const dashboardHost = pick(cli.dashboardHost, env.ALLSTAK_DASHBOARD_HOST, cfg.selfHosted?.dashboardHost, deriveDashboard(apiHost));
+    return {
+        organization: pick(cli.organization, env.ALLSTAK_ORG, cfg.organization, null),
+        project: pick(cli.project, env.ALLSTAK_PROJECT, cfg.project, null),
+        environment: pick(cli.environment, env.ALLSTAK_ENVIRONMENT, cfg.environment, 'production'),
+        release,
+        sourceMaps: {
+            enabled: cli.skipSourceMaps ? false : (cfg.sourceMaps?.enabled ?? true),
+            ignore: cfg.sourceMaps?.ignore ?? ['**/node_modules/**'],
+        },
+        hosts: { api: apiHost, ingest: ingestHost, dashboard: dashboardHost },
+        snapshotKeep: pick(cli.snapshotKeep, parseIntEnv(env.ALLSTAK_SNAPSHOT_KEEP), cfg.snapshotKeep, 10),
+    };
+}
+function pick(...values) {
+    for (const v of values) {
+        if (v !== undefined && v !== null)
+            return v;
+    }
+    // Last value is treated as the default — we always pass one, so this is
+    // safe at the type level.
+    return values[values.length - 1];
+}
+function parseIntEnv(s) {
+    if (!s)
+        return undefined;
+    const n = Number(s);
+    return Number.isFinite(n) ? n : undefined;
+}
+function materialiseRelease(input) {
+    if (typeof input === 'string')
+        return input;
+    if (typeof input === 'function') {
+        try {
+            const v = input();
+            return typeof v === 'string' && v.length > 0 ? v : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function deriveDashboard(api) {
+    if (api === DEFAULT_API_HOST)
+        return DEFAULT_DASHBOARD_HOST;
+    return api.replace(/^https?:\/\/api\./, (m) => m.replace('api.', 'app.'));
+}
+//# sourceMappingURL=precedence.js.map

package/dist/config/precedence.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,10 @@
+import type { WizardConfigInput } from './types.js';
+/**
+ * Hand-rolled validator. The wizard does NOT bring in zod/valibot for one
+ * config-file shape — it would be 100x the size of the validator itself.
+ *
+ * Returns a normalized clone with the user's input narrowed to known fields,
+ * or throws WizardError with a clear path-to-blame.
+ */
+export declare function validateConfigInput(input: unknown, source: string): WizardConfigInput;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAA6B,MAAM,YAAY,CAAC;AAG/E;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAsErF"}

package/dist/config/schema.js

@@ -0,0 +1,140 @@
+import { WizardError } from '../util/errors.js';
+import { CURRENT_CONFIG_SCHEMA_VERSION } from './types.js';
+/**
+ * Hand-rolled validator. The wizard does NOT bring in zod/valibot for one
+ * config-file shape — it would be 100x the size of the validator itself.
+ *
+ * Returns a normalized clone with the user's input narrowed to known fields,
+ * or throws WizardError with a clear path-to-blame.
+ */
+export function validateConfigInput(input, source) {
+    if (input === null || typeof input !== 'object') {
+        throw fail(source, '<root>', `expected an object, got ${typeOf(input)}`);
+    }
+    const cfg = input;
+    const out = {};
+    if (cfg.schemaVersion !== undefined) {
+        if (typeof cfg.schemaVersion !== 'number' || !Number.isInteger(cfg.schemaVersion) || cfg.schemaVersion < 1) {
+            throw fail(source, 'schemaVersion', `expected positive integer, got ${typeOf(cfg.schemaVersion)}`);
+        }
+        if (cfg.schemaVersion > CURRENT_CONFIG_SCHEMA_VERSION) {
+            throw fail(source, 'schemaVersion', `config declares schemaVersion=${cfg.schemaVersion}, but this wizard supports up to ${CURRENT_CONFIG_SCHEMA_VERSION}. Upgrade @allstak/wizard.`);
+        }
+        out.schemaVersion = cfg.schemaVersion;
+    }
+    if (cfg.organization !== undefined)
+        out.organization = expectString(source, 'organization', cfg.organization);
+    if (cfg.project !== undefined)
+        out.project = expectString(source, 'project', cfg.project);
+    if (cfg.environment !== undefined)
+        out.environment = expectString(source, 'environment', cfg.environment);
+    if (cfg.release !== undefined) {
+        if (typeof cfg.release === 'function')
+            out.release = cfg.release;
+        else if (typeof cfg.release === 'string')
+            out.release = cfg.release;
+        else
+            throw fail(source, 'release', `expected string or function, got ${typeOf(cfg.release)}`);
+    }
+    if (cfg.sourceMaps !== undefined) {
+        if (cfg.sourceMaps === null || typeof cfg.sourceMaps !== 'object') {
+            throw fail(source, 'sourceMaps', `expected object, got ${typeOf(cfg.sourceMaps)}`);
+        }
+        const sm = cfg.sourceMaps;
+        out.sourceMaps = {};
+        if (sm.enabled !== undefined)
+            out.sourceMaps.enabled = expectBoolean(source, 'sourceMaps.enabled', sm.enabled);
+        if (sm.ignore !== undefined) {
+            if (!Array.isArray(sm.ignore))
+                throw fail(source, 'sourceMaps.ignore', `expected array, got ${typeOf(sm.ignore)}`);
+            out.sourceMaps.ignore = sm.ignore.map((v, i) => expectString(source, `sourceMaps.ignore[${i}]`, v));
+        }
+    }
+    if (cfg.selfHosted !== undefined) {
+        if (cfg.selfHosted === null || typeof cfg.selfHosted !== 'object') {
+            throw fail(source, 'selfHosted', `expected object, got ${typeOf(cfg.selfHosted)}`);
+        }
+        const sh = cfg.selfHosted;
+        out.selfHosted = {};
+        if (sh.apiHost !== undefined)
+            out.selfHosted.apiHost = expectUrl(source, 'selfHosted.apiHost', sh.apiHost);
+        if (sh.ingestHost !== undefined)
+            out.selfHosted.ingestHost = expectUrl(source, 'selfHosted.ingestHost', sh.ingestHost);
+        if (sh.dashboardHost !== undefined)
+            out.selfHosted.dashboardHost = expectUrl(source, 'selfHosted.dashboardHost', sh.dashboardHost);
+    }
+    if (cfg.snapshotKeep !== undefined) {
+        if (typeof cfg.snapshotKeep !== 'number' || !Number.isFinite(cfg.snapshotKeep) || cfg.snapshotKeep < 0) {
+            throw fail(source, 'snapshotKeep', `expected non-negative number, got ${typeOf(cfg.snapshotKeep)}`);
+        }
+        out.snapshotKeep = cfg.snapshotKeep;
+    }
+    // Reject unknown top-level keys so typos surface immediately.
+    const allowed = new Set(['schemaVersion', 'organization', 'project', 'environment', 'release', 'sourceMaps', 'selfHosted', 'snapshotKeep']);
+    for (const key of Object.keys(cfg)) {
+        if (!allowed.has(key)) {
+            throw fail(source, key, `unknown config key. Did you mean ${nearest(key, allowed)}?`);
+        }
+    }
+    return out;
+}
+function expectString(source, path, v) {
+    if (typeof v !== 'string')
+        throw fail(source, path, `expected string, got ${typeOf(v)}`);
+    return v;
+}
+function expectBoolean(source, path, v) {
+    if (typeof v !== 'boolean')
+        throw fail(source, path, `expected boolean, got ${typeOf(v)}`);
+    return v;
+}
+function expectUrl(source, path, v) {
+    const s = expectString(source, path, v);
+    try {
+        new URL(s);
+    }
+    catch {
+        throw fail(source, path, `expected absolute URL, got "${s}"`);
+    }
+    return s;
+}
+function fail(source, path, msg) {
+    return new WizardError('E_CONFIG_INVALID', `${source}: ${path} — ${msg}`, {
+        subcode: 'E_CONFIG_SCHEMA',
+        context: { source, path: String(path) },
+    });
+}
+function typeOf(v) {
+    if (Array.isArray(v))
+        return 'array';
+    if (v === null)
+        return 'null';
+    return typeof v;
+}
+function nearest(input, candidates) {
+    let best = '';
+    let bestDist = Infinity;
+    for (const c of candidates) {
+        const d = levenshtein(input, c);
+        if (d < bestDist) {
+            bestDist = d;
+            best = c;
+        }
+    }
+    return bestDist <= 3 ? `"${best}"` : `one of ${Array.from(candidates).join(', ')}`;
+}
+function levenshtein(a, b) {
+    const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+    for (let i = 0; i <= a.length; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= b.length; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[a.length][b.length];
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * User-facing wizard config schema. Exposed via `allstak.config.{ts,js,mjs,cjs,json}`
+ * at the project root.
+ *
+ * Every field is optional — the wizard's precedence is:
+ *
+ *   CLI flag  >  env var  >  config file  >  built-in default
+ *
+ * Config exists so users can avoid repeating `--org`, `--project`, `--host`
+ * etc. on every invocation, especially in monorepos with multiple commands.
+ */
+/**
+ * Current config schema version. Bump when adding a backward-incompatible
+ * change. New optional fields do NOT require a bump; renames or removals do.
+ *
+ * Every released schemaVersion gets a forward migration registered in
+ * `src/config/migrations.ts` so old configs can be auto-migrated by
+ * `allstak config migrate`.
+ */
+export declare const CURRENT_CONFIG_SCHEMA_VERSION: 1;
+/** All schema versions that ever shipped — used by the migration runner. */
+export type WizardConfigSchemaVersion = 1;
+export interface WizardConfigInput {
+    /**
+     * Schema version this config was authored against. Optional for backwards
+     * compatibility — when missing the wizard treats the config as version 1.
+     * `allstak config migrate` will set it to the current version after
+     * applying any forward migrations.
+     */
+    schemaVersion?: WizardConfigSchemaVersion;
+    /** AllStak organization slug. Maps to --org. */
+    organization?: string;
+    /** AllStak project slug. Maps to --project. */
+    project?: string;
+    /** Default environment for events. Maps to --environment. */
+    environment?: string;
+    /** Release identifier — accepts a string or a function that returns one
+     *  (handy for `process.env.GIT_SHA` etc.). Maps to --release. */
+    release?: string | (() => string | undefined);
+    /** Source-map upload settings. */
+    sourceMaps?: {
+        enabled?: boolean;
+        /** Glob patterns to skip during source-map walk. Matches what the CLI passes downstream. */
+        ignore?: string[];
+    };
+    /** Self-hosted endpoints. */
+    selfHosted?: {
+        /** Maps to --ingest-host. Overrides --host for ingestion. */
+        ingestHost?: string;
+        /** Maps to --dashboard-host. */
+        dashboardHost?: string;
+        /** Maps to --host (control-plane API). */
+        apiHost?: string;
+    };
+    /** Snapshot retention count. Maps to --snapshot-keep. */
+    snapshotKeep?: number;
+}
+/**
+ * Resolved config — everything has a concrete value (or null) once the loader
+ * has applied env + defaults. Commands operate on this shape.
+ */
+export interface ResolvedWizardConfig {
+    organization: string | null;
+    project: string | null;
+    environment: string;
+    release: string | null;
+    sourceMaps: {
+        enabled: boolean;
+        ignore: string[];
+    };
+    hosts: {
+        api: string;
+        ingest: string;
+        dashboard: string;
+    };
+    snapshotKeep: number;
+}
+export declare const DEFAULT_API_HOST = "https://api.allstak.sa";
+export declare const DEFAULT_DASHBOARD_HOST = "https://app.allstak.sa";
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,EAAG,CAAU,CAAC;AAExD,4EAA4E;AAC5E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;qEACiE;IACjE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9C,kCAAkC;IAClC,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,4FAA4F;QAC5F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,6BAA6B;IAC7B,UAAU,CAAC,EAAE;QACX,6DAA6D;QAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gCAAgC;QAChC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,0CAA0C;QAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AACzD,eAAO,MAAM,sBAAsB,2BAA2B,CAAC"}

package/dist/config/types.js

@@ -0,0 +1,23 @@
+/**
+ * User-facing wizard config schema. Exposed via `allstak.config.{ts,js,mjs,cjs,json}`
+ * at the project root.
+ *
+ * Every field is optional — the wizard's precedence is:
+ *
+ *   CLI flag  >  env var  >  config file  >  built-in default
+ *
+ * Config exists so users can avoid repeating `--org`, `--project`, `--host`
+ * etc. on every invocation, especially in monorepos with multiple commands.
+ */
+/**
+ * Current config schema version. Bump when adding a backward-incompatible
+ * change. New optional fields do NOT require a bump; renames or removals do.
+ *
+ * Every released schemaVersion gets a forward migration registered in
+ * `src/config/migrations.ts` so old configs can be auto-migrated by
+ * `allstak config migrate`.
+ */
+export const CURRENT_CONFIG_SCHEMA_VERSION = 1;
+export const DEFAULT_API_HOST = 'https://api.allstak.sa';
+export const DEFAULT_DASHBOARD_HOST = 'https://app.allstak.sa';
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAU,CAAC;AA8DxD,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC"}

package/dist/credentials/encrypted-file.d.ts

@@ -0,0 +1,3 @@
+import type { CredentialStore } from './types.js';
+export declare const encryptedFileStore: CredentialStore;
+//# sourceMappingURL=encrypted-file.d.ts.map

package/dist/credentials/encrypted-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encrypted-file.d.ts","sourceRoot":"","sources":["../../src/credentials/encrypted-file.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAmG/D,eAAO,MAAM,kBAAkB,EAAE,eAyDhC,CAAC"}