@defai.digital/contracts 13.0.3

package/dist/config/v1/events.d.ts

@@ -0,0 +1,416 @@
+/**
+ * Configuration Events Contract V1
+ *
+ * Event schemas and state machine for configuration lifecycle.
+ *
+ * Invariants:
+ * - INV-CFG-DOM-003: State transitions follow CONFIG_TRANSITIONS
+ * - INV-CFG-GOV-001: All changes emit events
+ */
+import { z } from 'zod';
+/**
+ * Config status states
+ */
+export declare const ConfigStatusSchema: z.ZodEnum<["uninitialized", "valid", "invalid", "migrating"]>;
+export type ConfigStatus = z.infer<typeof ConfigStatusSchema>;
+/**
+ * Valid state transitions
+ *
+ * State machine:
+ * - uninitialized -> valid (create)
+ * - valid -> valid (update)
+ * - valid -> invalid (validation failure)
+ * - valid -> migrating (migration start)
+ * - invalid -> valid (fix)
+ * - invalid -> uninitialized (reset)
+ * - migrating -> valid (migration success)
+ * - migrating -> invalid (migration failure)
+ */
+export declare const CONFIG_TRANSITIONS: Record<ConfigStatus, ConfigStatus[]>;
+/**
+ * Checks if a state transition is valid
+ *
+ * INV-CFG-DOM-003: Transitions follow CONFIG_TRANSITIONS
+ */
+export declare function isValidConfigTransition(from: ConfigStatus, to: ConfigStatus): boolean;
+/**
+ * Config event types
+ */
+export declare const ConfigEventTypeSchema: z.ZodEnum<["config.created", "config.updated", "config.reset", "config.migrated", "config.deleted", "config.validationFailed"]>;
+export type ConfigEventType = z.infer<typeof ConfigEventTypeSchema>;
+/**
+ * Base config event (follows BaseEvent pattern)
+ */
+export declare const ConfigBaseEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodString;
+    version: z.ZodNumber;
+    correlationId: z.ZodString;
+    causationId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: number;
+    timestamp: string;
+    eventId: string;
+    correlationId: string;
+    traceId?: string | undefined;
+    causationId?: string | undefined;
+    spanId?: string | undefined;
+}, {
+    version: number;
+    timestamp: string;
+    eventId: string;
+    correlationId: string;
+    traceId?: string | undefined;
+    causationId?: string | undefined;
+    spanId?: string | undefined;
+}>;
+export type ConfigBaseEvent = z.infer<typeof ConfigBaseEventSchema>;
+/**
+ * Config created event payload
+ */
+export declare const ConfigCreatedPayloadSchema: z.ZodObject<{
+    type: z.ZodLiteral<"created">;
+    scope: z.ZodEnum<["global", "local"]>;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: "created";
+    config: Record<string, unknown>;
+    scope: "local" | "global";
+}, {
+    type: "created";
+    config: Record<string, unknown>;
+    scope: "local" | "global";
+}>;
+/**
+ * Config updated event payload
+ */
+export declare const ConfigUpdatedPayloadSchema: z.ZodObject<{
+    type: z.ZodLiteral<"updated">;
+    scope: z.ZodEnum<["global", "local"]>;
+    path: z.ZodString;
+    oldValue: z.ZodUnknown;
+    newValue: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "updated";
+    scope: "local" | "global";
+    oldValue?: unknown;
+    newValue?: unknown;
+}, {
+    path: string;
+    type: "updated";
+    scope: "local" | "global";
+    oldValue?: unknown;
+    newValue?: unknown;
+}>;
+/**
+ * Config reset event payload
+ */
+export declare const ConfigResetPayloadSchema: z.ZodObject<{
+    type: z.ZodLiteral<"reset">;
+    scope: z.ZodEnum<["global", "local"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "reset";
+    scope: "local" | "global";
+}, {
+    type: "reset";
+    scope: "local" | "global";
+}>;
+/**
+ * Config migrated event payload
+ */
+export declare const ConfigMigratedPayloadSchema: z.ZodObject<{
+    type: z.ZodLiteral<"migrated">;
+    fromVersion: z.ZodString;
+    toVersion: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "migrated";
+    fromVersion: string;
+    toVersion: string;
+}, {
+    type: "migrated";
+    fromVersion: string;
+    toVersion: string;
+}>;
+/**
+ * Config deleted event payload
+ */
+export declare const ConfigDeletedPayloadSchema: z.ZodObject<{
+    type: z.ZodLiteral<"deleted">;
+    scope: z.ZodEnum<["global", "local"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "deleted";
+    scope: "local" | "global";
+}, {
+    type: "deleted";
+    scope: "local" | "global";
+}>;
+/**
+ * Config validation failed event payload
+ */
+export declare const ConfigValidationFailedPayloadSchema: z.ZodObject<{
+    type: z.ZodLiteral<"validationFailed">;
+    errors: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "validationFailed";
+    errors: string[];
+}, {
+    type: "validationFailed";
+    errors: string[];
+}>;
+/**
+ * Config event payload discriminated union
+ */
+export declare const ConfigEventPayloadSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"created">;
+    scope: z.ZodEnum<["global", "local"]>;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: "created";
+    config: Record<string, unknown>;
+    scope: "local" | "global";
+}, {
+    type: "created";
+    config: Record<string, unknown>;
+    scope: "local" | "global";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"updated">;
+    scope: z.ZodEnum<["global", "local"]>;
+    path: z.ZodString;
+    oldValue: z.ZodUnknown;
+    newValue: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "updated";
+    scope: "local" | "global";
+    oldValue?: unknown;
+    newValue?: unknown;
+}, {
+    path: string;
+    type: "updated";
+    scope: "local" | "global";
+    oldValue?: unknown;
+    newValue?: unknown;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"reset">;
+    scope: z.ZodEnum<["global", "local"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "reset";
+    scope: "local" | "global";
+}, {
+    type: "reset";
+    scope: "local" | "global";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"migrated">;
+    fromVersion: z.ZodString;
+    toVersion: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "migrated";
+    fromVersion: string;
+    toVersion: string;
+}, {
+    type: "migrated";
+    fromVersion: string;
+    toVersion: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"deleted">;
+    scope: z.ZodEnum<["global", "local"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "deleted";
+    scope: "local" | "global";
+}, {
+    type: "deleted";
+    scope: "local" | "global";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"validationFailed">;
+    errors: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "validationFailed";
+    errors: string[];
+}, {
+    type: "validationFailed";
+    errors: string[];
+}>]>;
+export type ConfigEventPayload = z.infer<typeof ConfigEventPayloadSchema>;
+/**
+ * Full config event schema
+ */
+export declare const ConfigEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodString;
+    version: z.ZodNumber;
+    correlationId: z.ZodString;
+    causationId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodEnum<["config.created", "config.updated", "config.reset", "config.migrated", "config.deleted", "config.validationFailed"]>;
+    payload: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"created">;
+        scope: z.ZodEnum<["global", "local"]>;
+        config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        type: "created";
+        config: Record<string, unknown>;
+        scope: "local" | "global";
+    }, {
+        type: "created";
+        config: Record<string, unknown>;
+        scope: "local" | "global";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"updated">;
+        scope: z.ZodEnum<["global", "local"]>;
+        path: z.ZodString;
+        oldValue: z.ZodUnknown;
+        newValue: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        type: "updated";
+        scope: "local" | "global";
+        oldValue?: unknown;
+        newValue?: unknown;
+    }, {
+        path: string;
+        type: "updated";
+        scope: "local" | "global";
+        oldValue?: unknown;
+        newValue?: unknown;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"reset">;
+        scope: z.ZodEnum<["global", "local"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "reset";
+        scope: "local" | "global";
+    }, {
+        type: "reset";
+        scope: "local" | "global";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"migrated">;
+        fromVersion: z.ZodString;
+        toVersion: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "migrated";
+        fromVersion: string;
+        toVersion: string;
+    }, {
+        type: "migrated";
+        fromVersion: string;
+        toVersion: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"deleted">;
+        scope: z.ZodEnum<["global", "local"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "deleted";
+        scope: "local" | "global";
+    }, {
+        type: "deleted";
+        scope: "local" | "global";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"validationFailed">;
+        errors: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "validationFailed";
+        errors: string[];
+    }, {
+        type: "validationFailed";
+        errors: string[];
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    type: "config.created" | "config.updated" | "config.reset" | "config.migrated" | "config.deleted" | "config.validationFailed";
+    version: number;
+    timestamp: string;
+    eventId: string;
+    payload: {
+        type: "created";
+        config: Record<string, unknown>;
+        scope: "local" | "global";
+    } | {
+        path: string;
+        type: "updated";
+        scope: "local" | "global";
+        oldValue?: unknown;
+        newValue?: unknown;
+    } | {
+        type: "reset";
+        scope: "local" | "global";
+    } | {
+        type: "migrated";
+        fromVersion: string;
+        toVersion: string;
+    } | {
+        type: "deleted";
+        scope: "local" | "global";
+    } | {
+        type: "validationFailed";
+        errors: string[];
+    };
+    correlationId: string;
+    traceId?: string | undefined;
+    causationId?: string | undefined;
+    spanId?: string | undefined;
+}, {
+    type: "config.created" | "config.updated" | "config.reset" | "config.migrated" | "config.deleted" | "config.validationFailed";
+    version: number;
+    timestamp: string;
+    eventId: string;
+    payload: {
+        type: "created";
+        config: Record<string, unknown>;
+        scope: "local" | "global";
+    } | {
+        path: string;
+        type: "updated";
+        scope: "local" | "global";
+        oldValue?: unknown;
+        newValue?: unknown;
+    } | {
+        type: "reset";
+        scope: "local" | "global";
+    } | {
+        type: "migrated";
+        fromVersion: string;
+        toVersion: string;
+    } | {
+        type: "deleted";
+        scope: "local" | "global";
+    } | {
+        type: "validationFailed";
+        errors: string[];
+    };
+    correlationId: string;
+    traceId?: string | undefined;
+    causationId?: string | undefined;
+    spanId?: string | undefined;
+}>;
+export type ConfigEvent = z.infer<typeof ConfigEventSchema>;
+/**
+ * Creates a config event with generated ID and timestamp
+ */
+export declare function createConfigEvent(type: ConfigEventType, payload: ConfigEventPayload, correlationId: string, version: number, causationId?: string): ConfigEvent;
+/**
+ * Creates a config.created event
+ */
+export declare function createConfigCreatedEvent(scope: 'global' | 'local', config: Record<string, unknown>, correlationId: string, version: number): ConfigEvent;
+/**
+ * Creates a config.updated event
+ */
+export declare function createConfigUpdatedEvent(scope: 'global' | 'local', path: string, oldValue: unknown, newValue: unknown, correlationId: string, version: number): ConfigEvent;
+/**
+ * Creates a config.reset event
+ */
+export declare function createConfigResetEvent(scope: 'global' | 'local', correlationId: string, version: number): ConfigEvent;
+/**
+ * Creates a config.migrated event
+ */
+export declare function createConfigMigratedEvent(fromVersion: string, toVersion: string, correlationId: string, version: number): ConfigEvent;
+/**
+ * Creates a config.deleted event
+ */
+export declare function createConfigDeletedEvent(scope: 'global' | 'local', correlationId: string, version: number): ConfigEvent;
+/**
+ * Creates a config.validationFailed event
+ */
+export declare function createConfigValidationFailedEvent(errors: string[], correlationId: string, version: number): ConfigEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/config/v1/events.d.ts.map

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

package/dist/config/v1/events.js

@@ -0,0 +1,204 @@
+/**
+ * Configuration Events Contract V1
+ *
+ * Event schemas and state machine for configuration lifecycle.
+ *
+ * Invariants:
+ * - INV-CFG-DOM-003: State transitions follow CONFIG_TRANSITIONS
+ * - INV-CFG-GOV-001: All changes emit events
+ */
+import { z } from 'zod';
+import { ConfigScopeSchema } from './config.js';
+// ============================================================================
+// Config Status State Machine
+// ============================================================================
+/**
+ * Config status states
+ */
+export const ConfigStatusSchema = z.enum([
+    'uninitialized', // No config exists
+    'valid', // Config exists and is valid
+    'invalid', // Config exists but failed validation
+    'migrating', // Config is being migrated
+]);
+/**
+ * Valid state transitions
+ *
+ * State machine:
+ * - uninitialized -> valid (create)
+ * - valid -> valid (update)
+ * - valid -> invalid (validation failure)
+ * - valid -> migrating (migration start)
+ * - invalid -> valid (fix)
+ * - invalid -> uninitialized (reset)
+ * - migrating -> valid (migration success)
+ * - migrating -> invalid (migration failure)
+ */
+export const CONFIG_TRANSITIONS = {
+    uninitialized: ['valid'],
+    valid: ['valid', 'invalid', 'migrating'],
+    invalid: ['valid', 'uninitialized'],
+    migrating: ['valid', 'invalid'],
+};
+/**
+ * Checks if a state transition is valid
+ *
+ * INV-CFG-DOM-003: Transitions follow CONFIG_TRANSITIONS
+ */
+export function isValidConfigTransition(from, to) {
+    return CONFIG_TRANSITIONS[from].includes(to);
+}
+// ============================================================================
+// Config Event Types
+// ============================================================================
+/**
+ * Config event types
+ */
+export const ConfigEventTypeSchema = z.enum([
+    'config.created',
+    'config.updated',
+    'config.reset',
+    'config.migrated',
+    'config.deleted',
+    'config.validationFailed',
+]);
+// ============================================================================
+// Base Event Schema
+// ============================================================================
+/**
+ * Base config event (follows BaseEvent pattern)
+ */
+export const ConfigBaseEventSchema = z.object({
+    eventId: z.string().uuid(),
+    timestamp: z.string().datetime(),
+    version: z.number().int().min(1),
+    correlationId: z.string().uuid(),
+    causationId: z.string().uuid().optional(),
+    spanId: z.string().optional(),
+    traceId: z.string().optional(),
+});
+// ============================================================================
+// Event Payload Schemas
+// ============================================================================
+/**
+ * Config created event payload
+ */
+export const ConfigCreatedPayloadSchema = z.object({
+    type: z.literal('created'),
+    scope: ConfigScopeSchema,
+    config: z.record(z.unknown()),
+});
+/**
+ * Config updated event payload
+ */
+export const ConfigUpdatedPayloadSchema = z.object({
+    type: z.literal('updated'),
+    scope: ConfigScopeSchema,
+    path: z.string(),
+    oldValue: z.unknown(),
+    newValue: z.unknown(),
+});
+/**
+ * Config reset event payload
+ */
+export const ConfigResetPayloadSchema = z.object({
+    type: z.literal('reset'),
+    scope: ConfigScopeSchema,
+});
+/**
+ * Config migrated event payload
+ */
+export const ConfigMigratedPayloadSchema = z.object({
+    type: z.literal('migrated'),
+    fromVersion: z.string(),
+    toVersion: z.string(),
+});
+/**
+ * Config deleted event payload
+ */
+export const ConfigDeletedPayloadSchema = z.object({
+    type: z.literal('deleted'),
+    scope: ConfigScopeSchema,
+});
+/**
+ * Config validation failed event payload
+ */
+export const ConfigValidationFailedPayloadSchema = z.object({
+    type: z.literal('validationFailed'),
+    errors: z.array(z.string()),
+});
+/**
+ * Config event payload discriminated union
+ */
+export const ConfigEventPayloadSchema = z.discriminatedUnion('type', [
+    ConfigCreatedPayloadSchema,
+    ConfigUpdatedPayloadSchema,
+    ConfigResetPayloadSchema,
+    ConfigMigratedPayloadSchema,
+    ConfigDeletedPayloadSchema,
+    ConfigValidationFailedPayloadSchema,
+]);
+// ============================================================================
+// Full Event Schema
+// ============================================================================
+/**
+ * Full config event schema
+ */
+export const ConfigEventSchema = ConfigBaseEventSchema.extend({
+    type: ConfigEventTypeSchema,
+    payload: ConfigEventPayloadSchema,
+});
+// ============================================================================
+// Event Factory Functions
+// ============================================================================
+/**
+ * Creates a config event with generated ID and timestamp
+ */
+export function createConfigEvent(type, payload, correlationId, version, causationId) {
+    return {
+        eventId: crypto.randomUUID(),
+        timestamp: new Date().toISOString(),
+        version,
+        correlationId,
+        causationId,
+        type,
+        payload,
+    };
+}
+/**
+ * Creates a config.created event
+ */
+export function createConfigCreatedEvent(scope, config, correlationId, version) {
+    return createConfigEvent('config.created', { type: 'created', scope, config }, correlationId, version);
+}
+/**
+ * Creates a config.updated event
+ */
+export function createConfigUpdatedEvent(scope, path, oldValue, newValue, correlationId, version) {
+    return createConfigEvent('config.updated', { type: 'updated', scope, path, oldValue, newValue }, correlationId, version);
+}
+/**
+ * Creates a config.reset event
+ */
+export function createConfigResetEvent(scope, correlationId, version) {
+    return createConfigEvent('config.reset', { type: 'reset', scope }, correlationId, version);
+}
+/**
+ * Creates a config.migrated event
+ */
+export function createConfigMigratedEvent(fromVersion, toVersion, correlationId, version) {
+    return createConfigEvent('config.migrated', { type: 'migrated', fromVersion, toVersion }, correlationId, version);
+}
+/**
+ * Creates a config.deleted event
+ */
+export function createConfigDeletedEvent(scope, correlationId, version) {
+    return createConfigEvent('config.deleted', { type: 'deleted', scope }, correlationId, version);
+}
+/**
+ * Creates a config.validationFailed event
+ */
+export function createConfigValidationFailedEvent(errors, correlationId, version) {
+    return createConfigEvent('config.validationFailed', { type: 'validationFailed', errors }, correlationId, version);
+}
+//# sourceMappingURL=events.js.map

package/dist/config/v1/events.js.map

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

package/dist/config/v1/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Configuration Contract V1
+ *
+ * Re-exports all configuration schemas, types, and utilities.
+ */
+export { CONFIG_VERSION, LogLevelSchema, OutputFormatSchema, ConfigScopeSchema, ConfigReadScopeSchema, ConfigHealthCheckSchema, ConfigCircuitBreakerSchema, ConfigProcessManagementSchema, ConfigVersionDetectionSchema, ConfigLimitTrackingSchema, ConfigProviderTypeSchema, ProviderConfigSchema, ProvidersConfigSchema, ExecutionPolicySchema, FeatureFlagsSchema, WorkspaceConfigSchema, UserPreferencesSchema, AutomatosXConfigSchema, type LogLevel, type OutputFormat, type ConfigScope, type ConfigReadScope, type ConfigHealthCheck, type ConfigCircuitBreaker, type ConfigProcessManagement, type ConfigVersionDetection, type ConfigLimitTracking, type ConfigProviderType, type ProviderConfig, type ProvidersConfig, type ExecutionPolicy, type FeatureFlags, type WorkspaceConfig, type UserPreferences, type AutomatosXConfig, validateConfig, safeValidateConfig, validateConfigWithErrors, DEFAULT_CONFIG, } from './config.js';
+export { KNOWN_PROVIDERS, PROVIDER_DEFAULTS, ProviderIdSchema, ProviderDetectionResultSchema, ProviderDetectionSummarySchema, type ProviderId, type ProviderDetectionResult, type ProviderDetectionSummary, type ProviderDefault, isKnownProvider, getProviderDefault, createEmptyDetectionResult, createDetectionSummary, } from './provider-config.js';
+export { CONFIG_TRANSITIONS, ConfigStatusSchema, ConfigEventTypeSchema, ConfigBaseEventSchema, ConfigCreatedPayloadSchema, ConfigUpdatedPayloadSchema, ConfigResetPayloadSchema, ConfigMigratedPayloadSchema, ConfigDeletedPayloadSchema, ConfigValidationFailedPayloadSchema, ConfigEventPayloadSchema, ConfigEventSchema, type ConfigStatus, type ConfigEventType, type ConfigBaseEvent, type ConfigEventPayload, type ConfigEvent, isValidConfigTransition, createConfigEvent, createConfigCreatedEvent, createConfigUpdatedEvent, createConfigResetEvent, createConfigMigratedEvent, createConfigDeletedEvent, createConfigValidationFailedEvent, } from './events.js';
+export { SetupInputSchema, SetupOutputSchema, ConfigGetInputSchema, ConfigGetOutputSchema, ConfigSetInputSchema, ConfigSetOutputSchema, ConfigShowInputSchema, ConfigShowOutputSchema, ConfigResetInputSchema, ConfigResetOutputSchema, ConfigPathOutputSchema, DetectProvidersInputSchema, type SetupInput, type SetupOutput, type ConfigGetInput, type ConfigGetOutput, type ConfigSetInput, type ConfigSetOutput, type ConfigShowInput, type ConfigShowOutput, type ConfigResetInput, type ConfigResetOutput, type ConfigPathOutput, type DetectProvidersInput, validateSetupInput, validateConfigGetInput, validateConfigSetInput, validateConfigResetInput, } from './operations.js';
+export { ConfigErrorCode, CONFIG_ERROR_HINTS, type ConfigErrorCode as ConfigErrorCodeType, ConfigError, getRecoveryHint, configNotFoundError, configValidationError, providerNotDetectedError, providerNotAuthenticatedError, configInvalidTransitionError, configPathNotFoundError, isConfigError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/v1/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/v1/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAEL,cAAc,EAEd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EAGrB,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EAEtB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAErB,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EAExB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,eAAe,EACf,iBAAiB,EAEjB,gBAAgB,EAChB,6BAA6B,EAC7B,8BAA8B,EAE9B,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EAEpB,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,kBAAkB,EAElB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,mCAAmC,EACnC,wBAAwB,EACxB,iBAAiB,EAEjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAEhB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,GAClC,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAE1B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAEzB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAEL,eAAe,EACf,kBAAkB,EAElB,KAAK,eAAe,IAAI,mBAAmB,EAE3C,WAAW,EAEX,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,aAAa,GACd,MAAM,aAAa,CAAC"}