@uapkg/cli 1.4.0 → 1.5.0

package/dist/types/uapkg-config/schema/pathSchema.d.ts

@@ -0,0 +1,12 @@
+import { Result } from "../../uapkg-diagnostics/index.js";
+import { ZodType } from "zod";
+//#region src/schema/pathSchema.d.ts
+declare function validateConfigPath(pathToProperty: string): Result<void>;
+declare function isValidConfigPath(pathToProperty: string): boolean;
+declare function isLeafConfigPath(pathToProperty: string): boolean;
+declare function getConfigSchemaAtPath(pathToProperty: string): ZodType | null;
+declare function getValueByPath(data: unknown, pathToProperty?: string): unknown;
+declare function setValueByPath(target: Record<string, unknown>, pathToProperty: string, value: unknown): void;
+declare function deleteValueByPath(target: Record<string, unknown>, pathToProperty: string): boolean;
+//#endregion
+export { deleteValueByPath, getConfigSchemaAtPath, getValueByPath, isLeafConfigPath, isValidConfigPath, setValueByPath, validateConfigPath };

package/dist/types/uapkg-config/schema/runtime/ConfigCliValueParser.d.ts

@@ -0,0 +1,18 @@
+import { ConfigSchemaRuntime } from "./ConfigSchemaRuntime.js";
+import { Result } from "../../../uapkg-diagnostics/index.js";
+//#region src/schema/runtime/ConfigCliValueParser.d.ts
+/**
+ * Parses scalar CLI input (`uapkg config set ...`) using the schema node at
+ * the requested path as the source of truth.
+ */
+declare class ConfigCliValueParser {
+  private readonly runtime;
+  constructor(runtime: ConfigSchemaRuntime);
+  parse(pathToProperty: string, rawValue: string): Result<unknown>;
+  private coerce;
+  private coerceBoolean;
+  private coerceNumber;
+  private isRegistryUrlPath;
+}
+//#endregion
+export { ConfigCliValueParser };

package/dist/types/uapkg-config/schema/runtime/ConfigSchemaIntrospection.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+//#region src/schema/runtime/ConfigSchemaIntrospection.d.ts
+type ConfigSchemaNodeKind = 'object' | 'record' | 'string' | 'number' | 'boolean' | 'enum' | 'other';
+type ConfigObjectShape = Record<string, z.ZodType>;
+declare function unwrapConfigSchema(schema: z.ZodType): z.ZodType;
+declare function getConfigSchemaNodeKind(schema: z.ZodType): ConfigSchemaNodeKind;
+declare function getObjectShape(schema: z.ZodType): ConfigObjectShape;
+declare function getRecordValueSchema(schema: z.ZodType): z.ZodType | null;
+declare function getExpectedBroadType(kind: ConfigSchemaNodeKind): string;
+declare function isRecordValue(value: unknown): value is Record<string, unknown>;
+declare function describeValueType(value: unknown): string;
+//#endregion
+export { ConfigObjectShape, ConfigSchemaNodeKind, describeValueType, getConfigSchemaNodeKind, getExpectedBroadType, getObjectShape, getRecordValueSchema, isRecordValue, unwrapConfigSchema };

package/dist/types/uapkg-config/schema/runtime/ConfigSchemaRuntime.d.ts

@@ -0,0 +1,26 @@
+import { ConfigSchemaNodeKind } from "./ConfigSchemaIntrospection.js";
+import { z } from "zod";
+//#region src/schema/runtime/ConfigSchemaRuntime.d.ts
+interface ResolvedConfigSchemaPath {
+  readonly path: string;
+  readonly schema: z.ZodType;
+  readonly kind: ConfigSchemaNodeKind;
+}
+/**
+ * Runtime schema navigation for config paths.
+ *
+ * This keeps path validation and schema lookup derived from the Zod schema,
+ * avoiding duplicated hardcoded key maps.
+ */
+declare class ConfigSchemaRuntime {
+  private readonly root;
+  constructor(rootSchema: z.ZodType);
+  getRootSchema(): z.ZodType;
+  resolvePath(pathToProperty: string): ResolvedConfigSchemaPath | null;
+  getSchemaAtPath(pathToProperty: string): z.ZodType | null;
+  isValidPath(pathToProperty: string): boolean;
+  isLeafPath(pathToProperty: string): boolean;
+  private splitPath;
+}
+//#endregion
+export { ConfigSchemaRuntime, ResolvedConfigSchemaPath };

package/dist/types/uapkg-config/schema/runtime/ConfigSchemaRuntimeProvider.d.ts

@@ -0,0 +1,7 @@
+import { ConfigSchemaRuntime } from "./ConfigSchemaRuntime.js";
+import { Result } from "../../../uapkg-diagnostics/index.js";
+//#region src/schema/runtime/ConfigSchemaRuntimeProvider.d.ts
+declare function getConfigSchemaRuntime(): ConfigSchemaRuntime;
+declare function parseConfigCliValue(pathToProperty: string, rawValue: string): Result<unknown>;
+//#endregion
+export { getConfigSchemaRuntime, parseConfigCliValue };

package/dist/types/uapkg-diagnostics/base/Diagnostic.d.ts

@@ -0,0 +1,32 @@
+import { DiagnosticLevel } from "./DiagnosticLevel.js";
+//#region src/base/Diagnostic.d.ts
+type DiagnosticEmitPolicy = 'always' | 'once';
+/**
+ * Base shape for all diagnostics. Every concrete diagnostic must extend this
+ * interface, discriminating on `code` so that `data` is always strongly typed.
+ *
+ * @typeParam C - The string literal diagnostic code.
+ * @typeParam D - The shape of the typed data payload (defaults to `undefined`).
+ */
+interface DiagnosticBase<C extends string = string, D = undefined> {
+  /** Severity of this diagnostic. */
+  readonly level: DiagnosticLevel;
+  /** Stable, machine-readable code used for discrimination. */
+  readonly code: C;
+  /** Human-readable summary. */
+  readonly message: string;
+  /** Actionable hint shown to the user. */
+  readonly hint?: string;
+  /** Emit strategy for user-facing reporting. */
+  readonly emitPolicy?: DiagnosticEmitPolicy;
+  /** Stable dedupe key used when `emitPolicy` is `once`. */
+  readonly emitFingerprint?: string;
+  /** Strongly typed payload whose shape is determined by `code`. */
+  readonly data: D;
+}
+/** Create an error-level diagnostic. */
+declare function createDiagnostic<C extends string, D = undefined>(code: C, level: DiagnosticLevel, message: string, data: D, hint?: string, options?: {
+  readonly emitPolicy?: DiagnosticEmitPolicy;
+}): DiagnosticBase<C, D>;
+//#endregion
+export { DiagnosticBase, DiagnosticEmitPolicy, createDiagnostic };

package/dist/types/uapkg-diagnostics/base/DiagnosticBag.d.ts

@@ -0,0 +1,44 @@
+import { DiagnosticLevel } from "./DiagnosticLevel.js";
+import { Diagnostic } from "../types.js";
+import { Result } from "./Result.js";
+//#region src/base/DiagnosticBag.d.ts
+/**
+ * Mutable accumulator for diagnostics produced during an operation.
+ *
+ * Typical usage:
+ * ```ts
+ * const bag = new DiagnosticBag();
+ * bag.addError('MY_CODE', 'Something broke', undefined, 'Try X');
+ * if (bag.hasErrors()) return bag.toFailure();
+ * return bag.toResult(value);
+ * ```
+ */
+declare class DiagnosticBag {
+  private readonly items;
+  /** Number of diagnostics collected so far. */
+  get length(): number;
+  /** Add a pre-built diagnostic. */
+  add(diagnostic: Diagnostic): this;
+  /** Shorthand: add an error-level diagnostic. */
+  addError<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this;
+  /** Shorthand: add a warning-level diagnostic. */
+  addWarning<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this;
+  /** Shorthand: add an info-level diagnostic. */
+  addInfo<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this;
+  /** Merge another bag's diagnostics into this one. */
+  merge(other: DiagnosticBag): this;
+  /** Merge a readonly diagnostic array into this bag. */
+  mergeArray(diagnostics: readonly Diagnostic[]): this;
+  /** True if at least one diagnostic has level `error`. */
+  hasErrors(): boolean;
+  /** True if at least one diagnostic has the given level. */
+  hasLevel(level: DiagnosticLevel): boolean;
+  /** Return all collected diagnostics as a readonly array. */
+  all(): readonly Diagnostic[];
+  /** Build a successful `Result<T>` carrying accumulated diagnostics. */
+  toResult<T>(value: T): Result<T>;
+  /** Build a failed `Result` from the accumulated diagnostics. */
+  toFailure(): Result<never>;
+}
+//#endregion
+export { DiagnosticBag };

package/dist/types/uapkg-diagnostics/base/DiagnosticFingerprint.d.ts

@@ -0,0 +1,12 @@
+import { DiagnosticLevel } from "./DiagnosticLevel.js";
+//#region src/base/DiagnosticFingerprint.d.ts
+interface FingerprintInput {
+  readonly level: DiagnosticLevel;
+  readonly code: string;
+  readonly message: string;
+  readonly hint?: string;
+  readonly data: unknown;
+}
+declare function createDiagnosticFingerprint(input: FingerprintInput): string;
+//#endregion
+export { createDiagnosticFingerprint };

package/dist/types/uapkg-diagnostics/base/DiagnosticLevel.d.ts

@@ -0,0 +1,11 @@
+//#region src/base/DiagnosticLevel.d.ts
+/**
+ * Diagnostic severity levels.
+ *
+ * - `error`   – operation cannot continue
+ * - `warning` – operation can continue but something is concerning
+ * - `info`    – informational only
+ */
+type DiagnosticLevel = 'error' | 'warning' | 'info';
+//#endregion
+export { DiagnosticLevel };

package/dist/types/uapkg-diagnostics/base/Result.d.ts

@@ -0,0 +1,26 @@
+import { Diagnostic } from "../types.js";
+//#region src/base/Result.d.ts
+/** Successful result carrying a value and optional diagnostics. */
+interface ResultOk<T> {
+  readonly ok: true;
+  readonly value: T;
+  readonly diagnostics: readonly Diagnostic[];
+}
+/** Failed result carrying at least one diagnostic. */
+interface ResultFail {
+  readonly ok: false;
+  readonly diagnostics: readonly Diagnostic[];
+}
+/** Discriminated union returned by every fallible uapkg operation. */
+type Result<T> = ResultOk<T> | ResultFail;
+/** Create a successful result. */
+declare function ok<T>(value: T, diagnostics?: readonly Diagnostic[]): ResultOk<T>;
+/** Create a failed result. */
+declare function fail(diagnostics: readonly Diagnostic[]): ResultFail;
+/**
+ * Build a result from a diagnostics array and an optional value.
+ * If any diagnostic has level `error`, the result is a failure.
+ */
+declare function fromDiagnostics<T>(diagnostics: readonly Diagnostic[], value?: T): Result<T>;
+//#endregion
+export { Result, ResultFail, ResultOk, fail, fromDiagnostics, ok };

package/dist/types/uapkg-diagnostics/config/ConfigDiagnostics.d.ts

@@ -0,0 +1,49 @@
+import { DiagnosticBase } from "../base/Diagnostic.js";
+//#region src/config/ConfigDiagnostics.d.ts
+/** A config file contains invalid JSON and could not be parsed. */
+type ConfigInvalidJsonDiagnostic = DiagnosticBase<'CONFIG_INVALID_JSON', {
+  readonly filePath: string;
+  readonly reason: string;
+}>;
+/** Config value type is incompatible with expected merge shape. */
+type ConfigTypeMismatchDiagnostic = DiagnosticBase<'CONFIG_TYPE_MISMATCH', {
+  readonly path: string;
+  readonly expectedType: string;
+  readonly actualType: string;
+  readonly source: string;
+  readonly filePath?: string;
+}>;
+/** Unknown config key encountered in a config layer. */
+type ConfigUnknownKeyDiagnostic = DiagnosticBase<'CONFIG_UNKNOWN_KEY', {
+  readonly path: string;
+  readonly source: string;
+  readonly filePath?: string;
+}>;
+/** Cross-field semantic mismatch: default registry not defined in registries map. */
+type ConfigUnresolvedDefaultRegistryDiagnostic = DiagnosticBase<'CONFIG_UNRESOLVED_DEFAULT_REGISTRY', {
+  readonly registryName: string;
+}>;
+/** Value failed a narrower semantic validation rule. */
+type ConfigInvalidValueDiagnostic = DiagnosticBase<'CONFIG_INVALID_VALUE', {
+  readonly path: string;
+  readonly rule: string;
+}>;
+/** Union of all config diagnostics. */
+type ConfigDiagnostic = ConfigInvalidJsonDiagnostic | ConfigTypeMismatchDiagnostic | ConfigUnknownKeyDiagnostic | ConfigUnresolvedDefaultRegistryDiagnostic | ConfigInvalidValueDiagnostic;
+declare function createConfigInvalidJsonDiagnostic(filePath: string, reason: string): ConfigInvalidJsonDiagnostic;
+declare function createConfigTypeMismatchDiagnostic(input: {
+  readonly path: string;
+  readonly expectedType: string;
+  readonly actualType: string;
+  readonly source: string;
+  readonly filePath?: string;
+}): ConfigTypeMismatchDiagnostic;
+declare function createConfigUnknownKeyDiagnostic(input: {
+  readonly path: string;
+  readonly source: string;
+  readonly filePath?: string;
+}): ConfigUnknownKeyDiagnostic;
+declare function createConfigUnresolvedDefaultRegistryDiagnostic(registryName: string): ConfigUnresolvedDefaultRegistryDiagnostic;
+declare function createConfigInvalidValueDiagnostic(path: string, rule: string): ConfigInvalidValueDiagnostic;
+//#endregion
+export { ConfigDiagnostic, ConfigInvalidJsonDiagnostic, ConfigInvalidValueDiagnostic, ConfigTypeMismatchDiagnostic, ConfigUnknownKeyDiagnostic, ConfigUnresolvedDefaultRegistryDiagnostic, createConfigInvalidJsonDiagnostic, createConfigInvalidValueDiagnostic, createConfigTypeMismatchDiagnostic, createConfigUnknownKeyDiagnostic, createConfigUnresolvedDefaultRegistryDiagnostic };

package/dist/types/uapkg-diagnostics/controlPlane/ControlPlaneDiagnostics.d.ts

@@ -0,0 +1,25 @@
+import { DiagnosticBase } from "../base/Diagnostic.js";
+//#region src/controlPlane/ControlPlaneDiagnostics.d.ts
+type LoginDiagnosticCode = 'LOGIN_ACCESS_DENIED' | 'LOGIN_AUTHORIZATION_TIMEOUT' | 'LOGIN_AUTHORIZATION_RESPONSE_INVALID' | 'LOGIN_REAUTHORIZATION_CONFLICT' | 'LOGIN_OAUTH_ERROR' | 'LOGIN_FAILED';
+interface LoginDiagnosticData {
+  readonly oauthError?: string;
+}
+interface ControlPlaneCommandFailedDiagnosticData {
+  readonly operation: string;
+  readonly serverCode?: string;
+  readonly status?: number;
+}
+type LoginAccessDeniedDiagnostic = DiagnosticBase<'LOGIN_ACCESS_DENIED', LoginDiagnosticData>;
+type LoginAuthorizationTimeoutDiagnostic = DiagnosticBase<'LOGIN_AUTHORIZATION_TIMEOUT', LoginDiagnosticData>;
+type LoginAuthorizationResponseInvalidDiagnostic = DiagnosticBase<'LOGIN_AUTHORIZATION_RESPONSE_INVALID', LoginDiagnosticData>;
+type LoginReauthorizationConflictDiagnostic = DiagnosticBase<'LOGIN_REAUTHORIZATION_CONFLICT', LoginDiagnosticData>;
+type LoginOAuthErrorDiagnostic = DiagnosticBase<'LOGIN_OAUTH_ERROR', LoginDiagnosticData>;
+type LoginFailedDiagnostic = DiagnosticBase<'LOGIN_FAILED', LoginDiagnosticData>;
+type ControlPlaneCommandFailedDiagnostic = DiagnosticBase<'CONTROL_PLANE_COMMAND_FAILED', ControlPlaneCommandFailedDiagnosticData>;
+type ControlPlaneDiagnostic = LoginAccessDeniedDiagnostic | LoginAuthorizationTimeoutDiagnostic | LoginAuthorizationResponseInvalidDiagnostic | LoginReauthorizationConflictDiagnostic | LoginOAuthErrorDiagnostic | LoginFailedDiagnostic | ControlPlaneCommandFailedDiagnostic;
+type LoginDiagnosticByCode<C extends LoginDiagnosticCode> = Extract<ControlPlaneDiagnostic, {
+  code: C;
+}>;
+declare function createControlPlaneCommandFailedDiagnostic(message: string, data: ControlPlaneCommandFailedDiagnosticData): ControlPlaneCommandFailedDiagnostic;
+//#endregion
+export { ControlPlaneCommandFailedDiagnostic, ControlPlaneCommandFailedDiagnosticData, ControlPlaneDiagnostic, LoginAccessDeniedDiagnostic, LoginAuthorizationResponseInvalidDiagnostic, LoginAuthorizationTimeoutDiagnostic, LoginDiagnosticByCode, LoginDiagnosticCode, LoginDiagnosticData, LoginFailedDiagnostic, LoginOAuthErrorDiagnostic, LoginReauthorizationConflictDiagnostic, createControlPlaneCommandFailedDiagnostic };

package/dist/types/uapkg-diagnostics/general/GeneralDiagnostics.d.ts

@@ -0,0 +1,23 @@
+import { DiagnosticBase } from "../base/Diagnostic.js";
+//#region src/general/GeneralDiagnostics.d.ts
+/** Generic JSON or data parse error. */
+type ParseErrorDiagnostic = DiagnosticBase<'PARSE_ERROR', {
+  readonly filePath?: string;
+  readonly reason: string;
+}>;
+/** File system I/O error. */
+type IoErrorDiagnostic = DiagnosticBase<'IO_ERROR', {
+  readonly path: string;
+  readonly reason: string;
+}>;
+/** Catch-all for truly unexpected situations (should be rare). */
+type UnknownErrorDiagnostic = DiagnosticBase<'UNKNOWN_ERROR', {
+  readonly reason: string;
+}>;
+/** Union of all general diagnostics. */
+type GeneralDiagnostic = ParseErrorDiagnostic | IoErrorDiagnostic | UnknownErrorDiagnostic;
+declare function createParseErrorDiagnostic(reason: string, filePath?: string): ParseErrorDiagnostic;
+declare function createIoErrorDiagnostic(path: string, reason: string): IoErrorDiagnostic;
+declare function createUnknownErrorDiagnostic(reason: string): UnknownErrorDiagnostic;
+//#endregion
+export { GeneralDiagnostic, IoErrorDiagnostic, ParseErrorDiagnostic, UnknownErrorDiagnostic, createIoErrorDiagnostic, createParseErrorDiagnostic, createUnknownErrorDiagnostic };

package/dist/types/uapkg-diagnostics/index.d.ts

@@ -0,0 +1,20 @@
+import { DiagnosticLevel } from "./base/DiagnosticLevel.js";
+import { DiagnosticBase, DiagnosticEmitPolicy, createDiagnostic } from "./base/Diagnostic.js";
+import { ConfigDiagnostic, ConfigInvalidJsonDiagnostic, ConfigInvalidValueDiagnostic, ConfigTypeMismatchDiagnostic, ConfigUnknownKeyDiagnostic, ConfigUnresolvedDefaultRegistryDiagnostic, createConfigInvalidJsonDiagnostic, createConfigInvalidValueDiagnostic, createConfigTypeMismatchDiagnostic, createConfigUnknownKeyDiagnostic, createConfigUnresolvedDefaultRegistryDiagnostic } from "./config/ConfigDiagnostics.js";
+import { ControlPlaneCommandFailedDiagnostic, ControlPlaneCommandFailedDiagnosticData, ControlPlaneDiagnostic, LoginAccessDeniedDiagnostic, LoginAuthorizationResponseInvalidDiagnostic, LoginAuthorizationTimeoutDiagnostic, LoginDiagnosticByCode, LoginDiagnosticCode, LoginDiagnosticData, LoginFailedDiagnostic, LoginOAuthErrorDiagnostic, LoginReauthorizationConflictDiagnostic, createControlPlaneCommandFailedDiagnostic } from "./controlPlane/ControlPlaneDiagnostics.js";
+import { GeneralDiagnostic, IoErrorDiagnostic, ParseErrorDiagnostic, UnknownErrorDiagnostic, createIoErrorDiagnostic, createParseErrorDiagnostic, createUnknownErrorDiagnostic } from "./general/GeneralDiagnostics.js";
+import { DiskRemoveFailedDiagnostic, DownloadFailedDiagnostic, DownloadHttpStatusDiagnostic, ExtractionFailedDiagnostic, InstallerDiagnostic, IntegrityMismatchDiagnostic, NetworkRetriesExhaustedDiagnostic, NetworkTimeoutDiagnostic, createDiskRemoveFailedDiagnostic, createDownloadFailedDiagnostic, createDownloadHttpStatusDiagnostic, createExtractionFailedDiagnostic, createIntegrityMismatchDiagnostic, createNetworkRetriesExhaustedDiagnostic, createNetworkTimeoutDiagnostic } from "./installer/InstallerDiagnostics.js";
+import { DependencyNotFoundDiagnostic, ForbiddenOverridesDiagnostic, LockfileInvalidDiagnostic, LockfileMissingDiagnostic, LockfileOutOfSyncDiagnostic, ManifestDiagnostic, ManifestInvalidDiagnostic, ManifestReadErrorDiagnostic, ManifestWriteErrorDiagnostic, UnresolvedRegistryDiagnostic, createDependencyNotFoundDiagnostic, createForbiddenOverridesDiagnostic, createLockfileInvalidDiagnostic, createLockfileMissingDiagnostic, createLockfileOutOfSyncDiagnostic, createManifestInvalidDiagnostic, createManifestReadErrorDiagnostic, createManifestWriteErrorDiagnostic, createUnresolvedRegistryDiagnostic } from "./manifest/ManifestDiagnostics.js";
+import { CyclicSymlinkDiagnostic, InvalidPathDiagnostic, LfsSkippedDiagnostic, NoFilesSelectedDiagnostic, OutFileIsDirectoryDiagnostic, PackDiagnostic, PluginRootNotFoundDiagnostic, SymlinkOutsideRootDiagnostic, UnresolvedLfsDiagnostic, UpluginMissingDiagnostic, createCyclicSymlinkDiagnostic, createInvalidPathDiagnostic, createLfsSkippedDiagnostic, createNoFilesSelectedDiagnostic, createOutFileIsDirectoryDiagnostic, createPluginRootNotFoundDiagnostic, createSymlinkOutsideRootDiagnostic, createUnresolvedLfsDiagnostic, createUpluginMissingDiagnostic } from "./pack/PackDiagnostics.js";
+import { PostinstallDiagnostic, PostinstallDuplicateEntryDiagnostic, PostinstallEsbuildErrorDiagnostic, PostinstallInvalidExportDiagnostic, PostinstallLoadFailedDiagnostic, PostinstallMarkerCorruptDiagnostic, PostinstallPolicyDeniedDiagnostic, createPostinstallDuplicateEntryDiagnostic, createPostinstallEsbuildErrorDiagnostic, createPostinstallInvalidExportDiagnostic, createPostinstallLoadFailedDiagnostic, createPostinstallMarkerCorruptDiagnostic, createPostinstallPolicyDeniedDiagnostic } from "./postinstall/PostinstallDiagnostics.js";
+import { PublishDiagnosticFact, PublishDiagnosticResource, PublishRequestFailedDiagnostic, PublishRequestFailedDiagnosticData, PublishingDiagnostic, createPublishRequestFailedDiagnostic } from "./publishing/PublishingDiagnostics.js";
+import { CacheCorruptDiagnostic, CacheIdentifierCollisionDiagnostic, CacheReadErrorDiagnostic, GitErrorDiagnostic, LockAcquisitionFailedDiagnostic, NetworkErrorDiagnostic, RegistryDiagnostic, RegistryNotFoundDiagnostic, RegistryUnreachableDiagnostic, SchemaInvalidDiagnostic, createCacheCorruptDiagnostic, createCacheIdentifierCollisionDiagnostic, createCacheReadErrorDiagnostic, createGitErrorDiagnostic, createLockAcquisitionFailedDiagnostic, createNetworkErrorDiagnostic, createRegistryNotFoundDiagnostic, createRegistryUnreachableDiagnostic, createSchemaInvalidDiagnostic } from "./registry/RegistryDiagnostics.js";
+import { RegistryToolsDependencyNotInRegistryDiagnostic, RegistryToolsDependencyRangeUnreachableDiagnostic, RegistryToolsDiagnostic, RegistryToolsExternalRegistryDeniedDiagnostic, RegistryToolsExternalRegistryNotAllowedDiagnostic, RegistryToolsIntegrityMismatchDiagnostic, RegistryToolsOfficialPolicyViolationDiagnostic, RegistryToolsPackageMissingDiagnostic, RegistryToolsPackageSourceMismatchDiagnostic, RegistryToolsPathMismatchDiagnostic, RegistryToolsReleaseFileNameInvalidDiagnostic, RegistryToolsRemovalDeniedDiagnostic, RegistryToolsUnknownKeyDiagnostic, RegistryToolsVersionExistsDiagnostic, RegistryToolsVersionNotFoundDiagnostic, RegistryToolsVersionsUnsortedDiagnostic, createRegistryToolsDependencyNotInRegistryDiagnostic, createRegistryToolsDependencyRangeUnreachableDiagnostic, createRegistryToolsExternalRegistryDeniedDiagnostic, createRegistryToolsExternalRegistryNotAllowedDiagnostic, createRegistryToolsIntegrityMismatchDiagnostic, createRegistryToolsOfficialPolicyViolationDiagnostic, createRegistryToolsPackageMissingDiagnostic, createRegistryToolsPackageSourceMismatchDiagnostic, createRegistryToolsPathMismatchDiagnostic, createRegistryToolsReleaseFileNameInvalidDiagnostic, createRegistryToolsRemovalDeniedDiagnostic, createRegistryToolsUnknownKeyDiagnostic, createRegistryToolsVersionExistsDiagnostic, createRegistryToolsVersionNotFoundDiagnostic, createRegistryToolsVersionsUnsortedDiagnostic } from "./registryTools/RegistryToolsDiagnostics.js";
+import { CircularDepDiagnostic, PackageNotFoundDiagnostic, RegistryNameCollisionDiagnostic, ResolverDiagnostic, VersionConflictDiagnostic, VersionNotFoundDiagnostic, createCircularDepDiagnostic, createPackageNotFoundDiagnostic, createRegistryNameCollisionDiagnostic, createVersionConflictDiagnostic, createVersionNotFoundDiagnostic } from "./resolver/ResolverDiagnostics.js";
+import { SafetyDiagnostic, SafetyOverriddenByForceDiagnostic, SafetyPathNotProjectManifestDiagnostic, SafetyTargetExistsNoManifestDiagnostic, createSafetyOverriddenByForceDiagnostic, createSafetyPathNotProjectManifestDiagnostic, createSafetyTargetExistsNoManifestDiagnostic } from "./safety/SafetyDiagnostics.js";
+import { InvalidOrgNameDiagnostic, InvalidPackageSpecDiagnostic, InvalidVersionRangeDiagnostic, SpecParseDiagnostic, createInvalidOrgNameDiagnostic, createInvalidPackageSpecDiagnostic, createInvalidVersionRangeDiagnostic } from "./spec/SpecDiagnostics.js";
+import { Diagnostic, DiagnosticByCode, DiagnosticCode } from "./types.js";
+import { Result, ResultFail, ResultOk, fail, fromDiagnostics, ok } from "./base/Result.js";
+import { DiagnosticBag } from "./base/DiagnosticBag.js";
+import { createDiagnosticFingerprint } from "./base/DiagnosticFingerprint.js";
+export { type CacheCorruptDiagnostic, type CacheIdentifierCollisionDiagnostic, type CacheReadErrorDiagnostic, type CircularDepDiagnostic, type ConfigDiagnostic, type ConfigInvalidJsonDiagnostic, type ConfigInvalidValueDiagnostic, type ConfigTypeMismatchDiagnostic, type ConfigUnknownKeyDiagnostic, type ConfigUnresolvedDefaultRegistryDiagnostic, type ControlPlaneCommandFailedDiagnostic, type ControlPlaneCommandFailedDiagnosticData, type ControlPlaneDiagnostic, type CyclicSymlinkDiagnostic, type DependencyNotFoundDiagnostic, type Diagnostic, DiagnosticBag, type DiagnosticBase, type DiagnosticByCode, type DiagnosticCode, type DiagnosticEmitPolicy, type DiagnosticLevel, type DiskRemoveFailedDiagnostic, type DownloadFailedDiagnostic, type DownloadHttpStatusDiagnostic, type ExtractionFailedDiagnostic, type ForbiddenOverridesDiagnostic, type GeneralDiagnostic, type GitErrorDiagnostic, type InstallerDiagnostic, type IntegrityMismatchDiagnostic, type InvalidOrgNameDiagnostic, type InvalidPackageSpecDiagnostic, type InvalidPathDiagnostic, type InvalidVersionRangeDiagnostic, type IoErrorDiagnostic, type LfsSkippedDiagnostic, type LockAcquisitionFailedDiagnostic, type LockfileInvalidDiagnostic, type LockfileMissingDiagnostic, type LockfileOutOfSyncDiagnostic, type LoginAccessDeniedDiagnostic, type LoginAuthorizationResponseInvalidDiagnostic, type LoginAuthorizationTimeoutDiagnostic, type LoginDiagnosticByCode, type LoginDiagnosticCode, type LoginDiagnosticData, type LoginFailedDiagnostic, type LoginOAuthErrorDiagnostic, type LoginReauthorizationConflictDiagnostic, type ManifestDiagnostic, type ManifestInvalidDiagnostic, type ManifestReadErrorDiagnostic, type ManifestWriteErrorDiagnostic, type NetworkErrorDiagnostic, type NetworkRetriesExhaustedDiagnostic, type NetworkTimeoutDiagnostic, type NoFilesSelectedDiagnostic, type OutFileIsDirectoryDiagnostic, type PackDiagnostic, type PackageNotFoundDiagnostic, type ParseErrorDiagnostic, type PluginRootNotFoundDiagnostic, type PostinstallDiagnostic, type PostinstallDuplicateEntryDiagnostic, type PostinstallEsbuildErrorDiagnostic, type PostinstallInvalidExportDiagnostic, type PostinstallLoadFailedDiagnostic, type PostinstallMarkerCorruptDiagnostic, type PostinstallPolicyDeniedDiagnostic, type PublishDiagnosticFact, type PublishDiagnosticResource, type PublishRequestFailedDiagnostic, type PublishRequestFailedDiagnosticData, type PublishingDiagnostic, type RegistryDiagnostic, type RegistryNameCollisionDiagnostic, type RegistryNotFoundDiagnostic, type RegistryToolsDependencyNotInRegistryDiagnostic, type RegistryToolsDependencyRangeUnreachableDiagnostic, type RegistryToolsDiagnostic, type RegistryToolsExternalRegistryDeniedDiagnostic, type RegistryToolsExternalRegistryNotAllowedDiagnostic, type RegistryToolsIntegrityMismatchDiagnostic, type RegistryToolsOfficialPolicyViolationDiagnostic, type RegistryToolsPackageMissingDiagnostic, type RegistryToolsPackageSourceMismatchDiagnostic, type RegistryToolsPathMismatchDiagnostic, type RegistryToolsReleaseFileNameInvalidDiagnostic, type RegistryToolsRemovalDeniedDiagnostic, type RegistryToolsUnknownKeyDiagnostic, type RegistryToolsVersionExistsDiagnostic, type RegistryToolsVersionNotFoundDiagnostic, type RegistryToolsVersionsUnsortedDiagnostic, type RegistryUnreachableDiagnostic, type ResolverDiagnostic, type Result, type ResultFail, type ResultOk, type SafetyDiagnostic, type SafetyOverriddenByForceDiagnostic, type SafetyPathNotProjectManifestDiagnostic, type SafetyTargetExistsNoManifestDiagnostic, type SchemaInvalidDiagnostic, type SpecParseDiagnostic, type SymlinkOutsideRootDiagnostic, type UnknownErrorDiagnostic, type UnresolvedLfsDiagnostic, type UnresolvedRegistryDiagnostic, type UpluginMissingDiagnostic, type VersionConflictDiagnostic, type VersionNotFoundDiagnostic, createCacheCorruptDiagnostic, createCacheIdentifierCollisionDiagnostic, createCacheReadErrorDiagnostic, createCircularDepDiagnostic, createConfigInvalidJsonDiagnostic, createConfigInvalidValueDiagnostic, createConfigTypeMismatchDiagnostic, createConfigUnknownKeyDiagnostic, createConfigUnresolvedDefaultRegistryDiagnostic, createControlPlaneCommandFailedDiagnostic, createCyclicSymlinkDiagnostic, createDependencyNotFoundDiagnostic, createDiagnostic, createDiagnosticFingerprint, createDiskRemoveFailedDiagnostic, createDownloadFailedDiagnostic, createDownloadHttpStatusDiagnostic, createExtractionFailedDiagnostic, createForbiddenOverridesDiagnostic, createGitErrorDiagnostic, createIntegrityMismatchDiagnostic, createInvalidOrgNameDiagnostic, createInvalidPackageSpecDiagnostic, createInvalidPathDiagnostic, createInvalidVersionRangeDiagnostic, createIoErrorDiagnostic, createLfsSkippedDiagnostic, createLockAcquisitionFailedDiagnostic, createLockfileInvalidDiagnostic, createLockfileMissingDiagnostic, createLockfileOutOfSyncDiagnostic, createManifestInvalidDiagnostic, createManifestReadErrorDiagnostic, createManifestWriteErrorDiagnostic, createNetworkErrorDiagnostic, createNetworkRetriesExhaustedDiagnostic, createNetworkTimeoutDiagnostic, createNoFilesSelectedDiagnostic, createOutFileIsDirectoryDiagnostic, createPackageNotFoundDiagnostic, createParseErrorDiagnostic, createPluginRootNotFoundDiagnostic, createPostinstallDuplicateEntryDiagnostic, createPostinstallEsbuildErrorDiagnostic, createPostinstallInvalidExportDiagnostic, createPostinstallLoadFailedDiagnostic, createPostinstallMarkerCorruptDiagnostic, createPostinstallPolicyDeniedDiagnostic, createPublishRequestFailedDiagnostic, createRegistryNameCollisionDiagnostic, createRegistryNotFoundDiagnostic, createRegistryToolsDependencyNotInRegistryDiagnostic, createRegistryToolsDependencyRangeUnreachableDiagnostic, createRegistryToolsExternalRegistryDeniedDiagnostic, createRegistryToolsExternalRegistryNotAllowedDiagnostic, createRegistryToolsIntegrityMismatchDiagnostic, createRegistryToolsOfficialPolicyViolationDiagnostic, createRegistryToolsPackageMissingDiagnostic, createRegistryToolsPackageSourceMismatchDiagnostic, createRegistryToolsPathMismatchDiagnostic, createRegistryToolsReleaseFileNameInvalidDiagnostic, createRegistryToolsRemovalDeniedDiagnostic, createRegistryToolsUnknownKeyDiagnostic, createRegistryToolsVersionExistsDiagnostic, createRegistryToolsVersionNotFoundDiagnostic, createRegistryToolsVersionsUnsortedDiagnostic, createRegistryUnreachableDiagnostic, createSafetyOverriddenByForceDiagnostic, createSafetyPathNotProjectManifestDiagnostic, createSafetyTargetExistsNoManifestDiagnostic, createSchemaInvalidDiagnostic, createSymlinkOutsideRootDiagnostic, createUnknownErrorDiagnostic, createUnresolvedLfsDiagnostic, createUnresolvedRegistryDiagnostic, createUpluginMissingDiagnostic, createVersionConflictDiagnostic, createVersionNotFoundDiagnostic, fail, fromDiagnostics, ok };

package/dist/types/uapkg-diagnostics/installer/InstallerDiagnostics.d.ts

@@ -0,0 +1,55 @@
+import { DiagnosticBase } from "../base/Diagnostic.js";
+//#region src/installer/InstallerDiagnostics.d.ts
+/** HTTP download of a package .tgz asset failed. */
+type DownloadFailedDiagnostic = DiagnosticBase<'DOWNLOAD_FAILED', {
+  readonly packageName: string;
+  readonly url: string;
+  readonly reason: string;
+  readonly attempt: number;
+}>;
+/** Remote responded with a non-2xx HTTP status. */
+type DownloadHttpStatusDiagnostic = DiagnosticBase<'DOWNLOAD_HTTP_STATUS', {
+  readonly packageName: string;
+  readonly url: string;
+  readonly status: number;
+}>;
+/** Download timed out per `network.timeout`. */
+type NetworkTimeoutDiagnostic = DiagnosticBase<'NETWORK_TIMEOUT', {
+  readonly packageName: string;
+  readonly url: string;
+  readonly timeoutSeconds: number;
+}>;
+/** Retries exhausted per `network.retries`. */
+type NetworkRetriesExhaustedDiagnostic = DiagnosticBase<'NETWORK_RETRIES_EXHAUSTED', {
+  readonly packageName: string;
+  readonly url: string;
+  readonly attempts: number;
+}>;
+/** Downloaded file hash did not match the expected integrity from the registry. */
+type IntegrityMismatchDiagnostic = DiagnosticBase<'INTEGRITY_MISMATCH', {
+  readonly packageName: string;
+  readonly expected: string;
+  readonly actual: string;
+}>;
+/** Failed to extract a .tgz archive into the install path. */
+type ExtractionFailedDiagnostic = DiagnosticBase<'EXTRACTION_FAILED', {
+  readonly packageName: string;
+  readonly path: string;
+  readonly reason: string;
+}>;
+/** Failed to remove a package directory. */
+type DiskRemoveFailedDiagnostic = DiagnosticBase<'DISK_REMOVE_FAILED', {
+  readonly packageName: string;
+  readonly path: string;
+  readonly reason: string;
+}>;
+type InstallerDiagnostic = DownloadFailedDiagnostic | DownloadHttpStatusDiagnostic | NetworkTimeoutDiagnostic | NetworkRetriesExhaustedDiagnostic | IntegrityMismatchDiagnostic | ExtractionFailedDiagnostic | DiskRemoveFailedDiagnostic;
+declare function createDownloadFailedDiagnostic(packageName: string, url: string, reason: string, attempt: number): DownloadFailedDiagnostic;
+declare function createDownloadHttpStatusDiagnostic(packageName: string, url: string, status: number): DownloadHttpStatusDiagnostic;
+declare function createNetworkTimeoutDiagnostic(packageName: string, url: string, timeoutSeconds: number): NetworkTimeoutDiagnostic;
+declare function createNetworkRetriesExhaustedDiagnostic(packageName: string, url: string, attempts: number): NetworkRetriesExhaustedDiagnostic;
+declare function createIntegrityMismatchDiagnostic(packageName: string, expected: string, actual: string): IntegrityMismatchDiagnostic;
+declare function createExtractionFailedDiagnostic(packageName: string, path: string, reason: string): ExtractionFailedDiagnostic;
+declare function createDiskRemoveFailedDiagnostic(packageName: string, path: string, reason: string): DiskRemoveFailedDiagnostic;
+//#endregion
+export { DiskRemoveFailedDiagnostic, DownloadFailedDiagnostic, DownloadHttpStatusDiagnostic, ExtractionFailedDiagnostic, InstallerDiagnostic, IntegrityMismatchDiagnostic, NetworkRetriesExhaustedDiagnostic, NetworkTimeoutDiagnostic, createDiskRemoveFailedDiagnostic, createDownloadFailedDiagnostic, createDownloadHttpStatusDiagnostic, createExtractionFailedDiagnostic, createIntegrityMismatchDiagnostic, createNetworkRetriesExhaustedDiagnostic, createNetworkTimeoutDiagnostic };

package/dist/types/uapkg-diagnostics/manifest/ManifestDiagnostics.d.ts

@@ -0,0 +1,70 @@
+import { DiagnosticBase } from "../base/Diagnostic.js";
+//#region src/manifest/ManifestDiagnostics.d.ts
+/** Manifest content failed schema validation. */
+type ManifestInvalidDiagnostic = DiagnosticBase<'MANIFEST_INVALID', {
+  readonly filePath: string;
+  readonly issues: readonly string[];
+}>;
+/** Lockfile content failed schema validation. */
+type LockfileInvalidDiagnostic = DiagnosticBase<'LOCKFILE_INVALID', {
+  readonly filePath: string;
+  readonly issues: readonly string[];
+}>;
+/** Lockfile is missing from disk. */
+type LockfileMissingDiagnostic = DiagnosticBase<'LOCKFILE_MISSING', {
+  readonly filePath: string;
+}>;
+/** Lockfile is present but does not match manifest/config expectations. */
+type LockfileOutOfSyncDiagnostic = DiagnosticBase<'LOCKFILE_OUT_OF_SYNC', {
+  readonly issues: readonly {
+    readonly severity: 'error' | 'warning' | 'info';
+    readonly code: string;
+    readonly message: string;
+    readonly packageName?: string;
+  }[];
+  readonly totalIssues: number;
+  readonly additionalIssues: number;
+  readonly logFilePath: string;
+}>;
+/** Overrides are only allowed in root project manifests. */
+type ForbiddenOverridesDiagnostic = DiagnosticBase<'FORBIDDEN_OVERRIDES', {
+  readonly manifestKind: string;
+  readonly filePath: string;
+}>;
+/** A registry name referenced in a dependency is not in configuration. */
+type UnresolvedRegistryDiagnostic = DiagnosticBase<'UNRESOLVED_REGISTRY', {
+  readonly registryName: string;
+  readonly dependencyName: string;
+}>;
+/** Failed to read a manifest or lockfile from disk. */
+type ManifestReadErrorDiagnostic = DiagnosticBase<'MANIFEST_READ_ERROR', {
+  readonly filePath: string;
+  readonly reason: string;
+}>;
+/** Failed to write a manifest or lockfile to disk. */
+type ManifestWriteErrorDiagnostic = DiagnosticBase<'MANIFEST_WRITE_ERROR', {
+  readonly filePath: string;
+  readonly reason: string;
+}>;
+/** Remove was requested for a package that does not exist in manifest buckets. */
+type DependencyNotFoundDiagnostic = DiagnosticBase<'DEPENDENCY_NOT_FOUND', {
+  readonly packageName: string;
+}>;
+/** Union of all manifest diagnostics. */
+type ManifestDiagnostic = ManifestInvalidDiagnostic | LockfileInvalidDiagnostic | LockfileMissingDiagnostic | LockfileOutOfSyncDiagnostic | ForbiddenOverridesDiagnostic | UnresolvedRegistryDiagnostic | ManifestReadErrorDiagnostic | ManifestWriteErrorDiagnostic | DependencyNotFoundDiagnostic;
+declare function createManifestInvalidDiagnostic(filePath: string, issues: readonly string[]): ManifestInvalidDiagnostic;
+declare function createLockfileInvalidDiagnostic(filePath: string, issues: readonly string[]): LockfileInvalidDiagnostic;
+declare function createLockfileMissingDiagnostic(filePath: string, level?: 'warning' | 'error'): LockfileMissingDiagnostic;
+declare function createLockfileOutOfSyncDiagnostic(issues: readonly {
+  readonly severity: 'error' | 'warning' | 'info';
+  readonly code: string;
+  readonly message: string;
+  readonly packageName?: string;
+}[], totalIssues: number, logFilePath: string): LockfileOutOfSyncDiagnostic;
+declare function createForbiddenOverridesDiagnostic(manifestKind: string, filePath: string): ForbiddenOverridesDiagnostic;
+declare function createUnresolvedRegistryDiagnostic(registryName: string, dependencyName: string): UnresolvedRegistryDiagnostic;
+declare function createManifestReadErrorDiagnostic(filePath: string, reason: string): ManifestReadErrorDiagnostic;
+declare function createManifestWriteErrorDiagnostic(filePath: string, reason: string): ManifestWriteErrorDiagnostic;
+declare function createDependencyNotFoundDiagnostic(packageName: string): DependencyNotFoundDiagnostic;
+//#endregion
+export { DependencyNotFoundDiagnostic, ForbiddenOverridesDiagnostic, LockfileInvalidDiagnostic, LockfileMissingDiagnostic, LockfileOutOfSyncDiagnostic, ManifestDiagnostic, ManifestInvalidDiagnostic, ManifestReadErrorDiagnostic, ManifestWriteErrorDiagnostic, UnresolvedRegistryDiagnostic, createDependencyNotFoundDiagnostic, createForbiddenOverridesDiagnostic, createLockfileInvalidDiagnostic, createLockfileMissingDiagnostic, createLockfileOutOfSyncDiagnostic, createManifestInvalidDiagnostic, createManifestReadErrorDiagnostic, createManifestWriteErrorDiagnostic, createUnresolvedRegistryDiagnostic };

package/dist/types/uapkg-diagnostics/pack/PackDiagnostics.d.ts

@@ -0,0 +1,49 @@
+import { DiagnosticBase } from "../base/Diagnostic.js";
+//#region src/pack/PackDiagnostics.d.ts
+/** Cyclic symlink detected during file crawl. */
+type CyclicSymlinkDiagnostic = DiagnosticBase<'CYCLIC_SYMLINK', {
+  readonly filePath: string;
+}>;
+/** Symlink resolves outside the plugin root. */
+type SymlinkOutsideRootDiagnostic = DiagnosticBase<'SYMLINK_OUTSIDE_ROOT', {
+  readonly filePath: string;
+}>;
+/** Path normalization produced an invalid result. */
+type InvalidPathDiagnostic = DiagnosticBase<'INVALID_PATH', {
+  readonly filePath: string;
+}>;
+/** No uapkg.json found walking upward from cwd. */
+type PluginRootNotFoundDiagnostic = DiagnosticBase<'PLUGIN_ROOT_NOT_FOUND', {
+  readonly cwd: string;
+}>;
+/** Unresolved LFS pointer file (fatal when --allow-missing-lfs is off). */
+type UnresolvedLfsDiagnostic = DiagnosticBase<'UNRESOLVED_LFS', {
+  readonly filePath: string;
+}>;
+/** LFS pointer was skipped (warning when --allow-missing-lfs is on). */
+type LfsSkippedDiagnostic = DiagnosticBase<'LFS_SKIPPED', {
+  readonly filePath: string;
+}>;
+/** No files were selected for packing after filtering. */
+type NoFilesSelectedDiagnostic = DiagnosticBase<'NO_FILES_SELECTED', Record<string, never>>;
+/** --outFile resolved to a directory instead of a file. */
+type OutFileIsDirectoryDiagnostic = DiagnosticBase<'OUTFILE_IS_DIRECTORY', {
+  readonly filePath: string;
+}>;
+/** Plugin descriptor (*.uplugin) is required for pack operations. */
+type UpluginMissingDiagnostic = DiagnosticBase<'UPLUGIN_MISSING', {
+  readonly pluginRoot: string;
+}>;
+/** Union of all pack diagnostics. */
+type PackDiagnostic = CyclicSymlinkDiagnostic | SymlinkOutsideRootDiagnostic | InvalidPathDiagnostic | PluginRootNotFoundDiagnostic | UnresolvedLfsDiagnostic | LfsSkippedDiagnostic | NoFilesSelectedDiagnostic | OutFileIsDirectoryDiagnostic | UpluginMissingDiagnostic;
+declare function createCyclicSymlinkDiagnostic(filePath: string): CyclicSymlinkDiagnostic;
+declare function createSymlinkOutsideRootDiagnostic(filePath: string): SymlinkOutsideRootDiagnostic;
+declare function createInvalidPathDiagnostic(filePath: string): InvalidPathDiagnostic;
+declare function createPluginRootNotFoundDiagnostic(cwd: string): PluginRootNotFoundDiagnostic;
+declare function createUnresolvedLfsDiagnostic(filePath: string): UnresolvedLfsDiagnostic;
+declare function createLfsSkippedDiagnostic(filePath: string): LfsSkippedDiagnostic;
+declare function createNoFilesSelectedDiagnostic(): NoFilesSelectedDiagnostic;
+declare function createOutFileIsDirectoryDiagnostic(filePath: string): OutFileIsDirectoryDiagnostic;
+declare function createUpluginMissingDiagnostic(pluginRoot: string): UpluginMissingDiagnostic;
+//#endregion
+export { CyclicSymlinkDiagnostic, InvalidPathDiagnostic, LfsSkippedDiagnostic, NoFilesSelectedDiagnostic, OutFileIsDirectoryDiagnostic, PackDiagnostic, PluginRootNotFoundDiagnostic, SymlinkOutsideRootDiagnostic, UnresolvedLfsDiagnostic, UpluginMissingDiagnostic, createCyclicSymlinkDiagnostic, createInvalidPathDiagnostic, createLfsSkippedDiagnostic, createNoFilesSelectedDiagnostic, createOutFileIsDirectoryDiagnostic, createPluginRootNotFoundDiagnostic, createSymlinkOutsideRootDiagnostic, createUnresolvedLfsDiagnostic, createUpluginMissingDiagnostic };

package/dist/types/uapkg-diagnostics/postinstall/PostinstallDiagnostics.d.ts

@@ -0,0 +1,47 @@
+import { DiagnosticBase } from "../base/Diagnostic.js";
+//#region src/postinstall/PostinstallDiagnostics.d.ts
+/** Postinstall was denied by policy (install.postInstallPolicy or per-registry override). */
+type PostinstallPolicyDeniedDiagnostic = DiagnosticBase<'POSTINSTALL_POLICY_DENIED', {
+  readonly packageName: string;
+  readonly registry: string;
+  readonly policy: 'allow' | 'deny';
+  readonly resolvedFrom: 'registry' | 'install';
+}>;
+/** Loading the postinstall module failed (e.g. import error). */
+type PostinstallLoadFailedDiagnostic = DiagnosticBase<'POSTINSTALL_LOAD_FAILED', {
+  readonly packageName: string;
+  readonly entryFile: string;
+  readonly reason: string;
+}>;
+/** The postinstall module's default export failed Zod validation. */
+type PostinstallInvalidExportDiagnostic = DiagnosticBase<'POSTINSTALL_INVALID_EXPORT', {
+  readonly packageName: string;
+  readonly entryFile: string;
+  readonly issues: readonly string[];
+}>;
+/** More than one candidate postinstall entry file exists (e.g. both .ts and .js). */
+type PostinstallDuplicateEntryDiagnostic = DiagnosticBase<'POSTINSTALL_DUPLICATE_ENTRY', {
+  readonly packageName: string;
+  readonly candidates: readonly string[];
+}>;
+/** Marker-block in a generated file is corrupt or was edited manually. */
+type PostinstallMarkerCorruptDiagnostic = DiagnosticBase<'POSTINSTALL_MARKER_CORRUPT', {
+  readonly packageName: string;
+  readonly file: string;
+  readonly reason: string;
+}>;
+/** esbuild failed to transpile a `.ts` postinstall entry file. */
+type PostinstallEsbuildErrorDiagnostic = DiagnosticBase<'POSTINSTALL_ESBUILD_ERROR', {
+  readonly packageName: string;
+  readonly entryFile: string;
+  readonly reason: string;
+}>;
+type PostinstallDiagnostic = PostinstallPolicyDeniedDiagnostic | PostinstallLoadFailedDiagnostic | PostinstallInvalidExportDiagnostic | PostinstallDuplicateEntryDiagnostic | PostinstallMarkerCorruptDiagnostic | PostinstallEsbuildErrorDiagnostic;
+declare function createPostinstallPolicyDeniedDiagnostic(packageName: string, registry: string, policy: 'allow' | 'deny', resolvedFrom: 'registry' | 'install'): PostinstallPolicyDeniedDiagnostic;
+declare function createPostinstallLoadFailedDiagnostic(packageName: string, entryFile: string, reason: string): PostinstallLoadFailedDiagnostic;
+declare function createPostinstallInvalidExportDiagnostic(packageName: string, entryFile: string, issues: readonly string[]): PostinstallInvalidExportDiagnostic;
+declare function createPostinstallDuplicateEntryDiagnostic(packageName: string, candidates: readonly string[]): PostinstallDuplicateEntryDiagnostic;
+declare function createPostinstallMarkerCorruptDiagnostic(packageName: string, file: string, reason: string): PostinstallMarkerCorruptDiagnostic;
+declare function createPostinstallEsbuildErrorDiagnostic(packageName: string, entryFile: string, reason: string): PostinstallEsbuildErrorDiagnostic;
+//#endregion
+export { PostinstallDiagnostic, PostinstallDuplicateEntryDiagnostic, PostinstallEsbuildErrorDiagnostic, PostinstallInvalidExportDiagnostic, PostinstallLoadFailedDiagnostic, PostinstallMarkerCorruptDiagnostic, PostinstallPolicyDeniedDiagnostic, createPostinstallDuplicateEntryDiagnostic, createPostinstallEsbuildErrorDiagnostic, createPostinstallInvalidExportDiagnostic, createPostinstallLoadFailedDiagnostic, createPostinstallMarkerCorruptDiagnostic, createPostinstallPolicyDeniedDiagnostic };