@uapkg/diagnostics 1.1.7 → 1.1.9

package/dist/installer/InstallerDiagnostics.d.ts.map

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

package/dist/installer/InstallerDiagnostics.js

@@ -0,0 +1,64 @@
+// ---------------------------------------------------------------------------
+// Factories
+// ---------------------------------------------------------------------------
+export function createDownloadFailedDiagnostic(packageName, url, reason, attempt) {
+    return {
+        level: 'error',
+        code: 'DOWNLOAD_FAILED',
+        message: `Download of "${packageName}" failed (attempt ${attempt}): ${reason}.`,
+        hint: 'Check your network connection and registry URL.',
+        data: { packageName, url, reason, attempt },
+    };
+}
+export function createDownloadHttpStatusDiagnostic(packageName, url, status) {
+    return {
+        level: 'error',
+        code: 'DOWNLOAD_HTTP_STATUS',
+        message: `Download of "${packageName}" returned HTTP ${status}.`,
+        data: { packageName, url, status },
+    };
+}
+export function createNetworkTimeoutDiagnostic(packageName, url, timeoutSeconds) {
+    return {
+        level: 'error',
+        code: 'NETWORK_TIMEOUT',
+        message: `Download of "${packageName}" timed out after ${timeoutSeconds}s.`,
+        hint: 'Increase `network.timeout` in your uapkg config.',
+        data: { packageName, url, timeoutSeconds },
+    };
+}
+export function createNetworkRetriesExhaustedDiagnostic(packageName, url, attempts) {
+    return {
+        level: 'error',
+        code: 'NETWORK_RETRIES_EXHAUSTED',
+        message: `Giving up on "${packageName}" after ${attempts} attempts.`,
+        hint: 'Increase `network.retries` or check network stability.',
+        data: { packageName, url, attempts },
+    };
+}
+export function createIntegrityMismatchDiagnostic(packageName, expected, actual) {
+    return {
+        level: 'error',
+        code: 'INTEGRITY_MISMATCH',
+        message: `Integrity mismatch for "${packageName}".`,
+        hint: 'The download may be corrupt or the registry entry has changed; re-run or report to the registry.',
+        data: { packageName, expected, actual },
+    };
+}
+export function createExtractionFailedDiagnostic(packageName, path, reason) {
+    return {
+        level: 'error',
+        code: 'EXTRACTION_FAILED',
+        message: `Extraction of "${packageName}" to "${path}" failed: ${reason}.`,
+        data: { packageName, path, reason },
+    };
+}
+export function createDiskRemoveFailedDiagnostic(packageName, path, reason) {
+    return {
+        level: 'error',
+        code: 'DISK_REMOVE_FAILED',
+        message: `Failed to remove "${packageName}" at "${path}": ${reason}.`,
+        data: { packageName, path, reason },
+    };
+}
+//# sourceMappingURL=InstallerDiagnostics.js.map

package/dist/installer/InstallerDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallerDiagnostics.js","sourceRoot":"","sources":["../../src/installer/InstallerDiagnostics.ts"],"names":[],"mappings":"AAsFA,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,UAAU,8BAA8B,CAC5C,WAAmB,EACnB,GAAW,EACX,MAAc,EACd,OAAe;IAEf,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,gBAAgB,WAAW,qBAAqB,OAAO,MAAM,MAAM,GAAG;QAC/E,IAAI,EAAE,iDAAiD;QACvD,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,WAAmB,EACnB,GAAW,EACX,MAAc;IAEd,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,gBAAgB,WAAW,mBAAmB,MAAM,GAAG;QAChE,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,WAAmB,EACnB,GAAW,EACX,cAAsB;IAEtB,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,gBAAgB,WAAW,qBAAqB,cAAc,IAAI;QAC3E,IAAI,EAAE,kDAAkD;QACxD,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,WAAmB,EACnB,GAAW,EACX,QAAgB;IAEhB,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,iBAAiB,WAAW,WAAW,QAAQ,YAAY;QACpE,IAAI,EAAE,wDAAwD;QAC9D,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,WAAmB,EACnB,QAAgB,EAChB,MAAc;IAEd,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,2BAA2B,WAAW,IAAI;QACnD,IAAI,EAAE,kGAAkG;QACxG,IAAI,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,WAAmB,EACnB,IAAY,EACZ,MAAc;IAEd,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,kBAAkB,WAAW,SAAS,IAAI,aAAa,MAAM,GAAG;QACzE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,WAAmB,EACnB,IAAY,EACZ,MAAc;IAEd,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,qBAAqB,WAAW,SAAS,IAAI,MAAM,MAAM,GAAG;QACrE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/manifest/ManifestDiagnostics.d.ts

@@ -0,0 +1,68 @@
+import type { DiagnosticBase } from '../base/Diagnostic.js';
+/** Manifest content failed schema validation. */
+export type ManifestInvalidDiagnostic = DiagnosticBase<'MANIFEST_INVALID', {
+    readonly filePath: string;
+    readonly issues: readonly string[];
+}>;
+/** Lockfile content failed schema validation. */
+export type LockfileInvalidDiagnostic = DiagnosticBase<'LOCKFILE_INVALID', {
+    readonly filePath: string;
+    readonly issues: readonly string[];
+}>;
+/** Lockfile is missing from disk. */
+export type LockfileMissingDiagnostic = DiagnosticBase<'LOCKFILE_MISSING', {
+    readonly filePath: string;
+}>;
+/** Lockfile is present but does not match manifest/config expectations. */
+export 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. */
+export type ForbiddenOverridesDiagnostic = DiagnosticBase<'FORBIDDEN_OVERRIDES', {
+    readonly manifestKind: string;
+    readonly filePath: string;
+}>;
+/** A registry name referenced in a dependency is not in configuration. */
+export type UnresolvedRegistryDiagnostic = DiagnosticBase<'UNRESOLVED_REGISTRY', {
+    readonly registryName: string;
+    readonly dependencyName: string;
+}>;
+/** Failed to read a manifest or lockfile from disk. */
+export type ManifestReadErrorDiagnostic = DiagnosticBase<'MANIFEST_READ_ERROR', {
+    readonly filePath: string;
+    readonly reason: string;
+}>;
+/** Failed to write a manifest or lockfile to disk. */
+export 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. */
+export type DependencyNotFoundDiagnostic = DiagnosticBase<'DEPENDENCY_NOT_FOUND', {
+    readonly packageName: string;
+}>;
+/** Union of all manifest diagnostics. */
+export type ManifestDiagnostic = ManifestInvalidDiagnostic | LockfileInvalidDiagnostic | LockfileMissingDiagnostic | LockfileOutOfSyncDiagnostic | ForbiddenOverridesDiagnostic | UnresolvedRegistryDiagnostic | ManifestReadErrorDiagnostic | ManifestWriteErrorDiagnostic | DependencyNotFoundDiagnostic;
+export declare function createManifestInvalidDiagnostic(filePath: string, issues: readonly string[]): ManifestInvalidDiagnostic;
+export declare function createLockfileInvalidDiagnostic(filePath: string, issues: readonly string[]): LockfileInvalidDiagnostic;
+export declare function createLockfileMissingDiagnostic(filePath: string, level?: 'warning' | 'error'): LockfileMissingDiagnostic;
+export declare function createLockfileOutOfSyncDiagnostic(issues: readonly {
+    readonly severity: 'error' | 'warning' | 'info';
+    readonly code: string;
+    readonly message: string;
+    readonly packageName?: string;
+}[], totalIssues: number, logFilePath: string): LockfileOutOfSyncDiagnostic;
+export declare function createForbiddenOverridesDiagnostic(manifestKind: string, filePath: string): ForbiddenOverridesDiagnostic;
+export declare function createUnresolvedRegistryDiagnostic(registryName: string, dependencyName: string): UnresolvedRegistryDiagnostic;
+export declare function createManifestReadErrorDiagnostic(filePath: string, reason: string): ManifestReadErrorDiagnostic;
+export declare function createManifestWriteErrorDiagnostic(filePath: string, reason: string): ManifestWriteErrorDiagnostic;
+export declare function createDependencyNotFoundDiagnostic(packageName: string): DependencyNotFoundDiagnostic;
+//# sourceMappingURL=ManifestDiagnostics.d.ts.map

package/dist/manifest/ManifestDiagnostics.d.ts.map

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

package/dist/manifest/ManifestDiagnostics.js

@@ -0,0 +1,90 @@
+// ---------------------------------------------------------------------------
+// Factory helpers
+// ---------------------------------------------------------------------------
+export function createManifestInvalidDiagnostic(filePath, issues) {
+    return {
+        level: 'error',
+        code: 'MANIFEST_INVALID',
+        message: `Manifest validation failed for "${filePath}".`,
+        hint: 'Review your uapkg.json against the expected schema.',
+        data: { filePath, issues },
+    };
+}
+export function createLockfileInvalidDiagnostic(filePath, issues) {
+    return {
+        level: 'error',
+        code: 'LOCKFILE_INVALID',
+        message: `Lockfile validation failed for "${filePath}".`,
+        hint: 'Delete uapkg.lock and re-run install to regenerate.',
+        data: { filePath, issues },
+    };
+}
+export function createLockfileMissingDiagnostic(filePath, level = 'warning') {
+    return {
+        level,
+        code: 'LOCKFILE_MISSING',
+        message: `No lockfile found at "${filePath}".`,
+        hint: 'Run `uapkg install` to generate a lockfile, or use `--frozen` only when one already exists.',
+        data: { filePath },
+    };
+}
+export function createLockfileOutOfSyncDiagnostic(issues, totalIssues, logFilePath) {
+    return {
+        level: 'error',
+        code: 'LOCKFILE_OUT_OF_SYNC',
+        message: 'Lockfile is out of sync with the current manifest and registry state.',
+        hint: 'Run `uapkg install` or `uapkg update` to regenerate the lockfile before using `--frozen`.',
+        data: {
+            issues,
+            totalIssues,
+            additionalIssues: Math.max(0, totalIssues - issues.length),
+            logFilePath,
+        },
+    };
+}
+export function createForbiddenOverridesDiagnostic(manifestKind, filePath) {
+    return {
+        level: 'error',
+        code: 'FORBIDDEN_OVERRIDES',
+        message: `Overrides are not allowed in "${manifestKind}" manifests ("${filePath}").`,
+        hint: 'Overrides may only appear in root project manifests.',
+        data: { manifestKind, filePath },
+    };
+}
+export function createUnresolvedRegistryDiagnostic(registryName, dependencyName) {
+    return {
+        level: 'error',
+        code: 'UNRESOLVED_REGISTRY',
+        message: `Registry "${registryName}" referenced by dependency "${dependencyName}" is not configured.`,
+        hint: 'Add the registry to your uapkg configuration.',
+        data: { registryName, dependencyName },
+    };
+}
+export function createManifestReadErrorDiagnostic(filePath, reason) {
+    return {
+        level: 'error',
+        code: 'MANIFEST_READ_ERROR',
+        message: `Failed to read "${filePath}": ${reason}.`,
+        hint: 'Ensure the file exists and is valid JSON.',
+        data: { filePath, reason },
+    };
+}
+export function createManifestWriteErrorDiagnostic(filePath, reason) {
+    return {
+        level: 'error',
+        code: 'MANIFEST_WRITE_ERROR',
+        message: `Failed to write "${filePath}": ${reason}.`,
+        hint: 'Ensure the directory exists and you have write permissions.',
+        data: { filePath, reason },
+    };
+}
+export function createDependencyNotFoundDiagnostic(packageName) {
+    return {
+        level: 'info',
+        code: 'DEPENDENCY_NOT_FOUND',
+        message: `Package "${packageName}" is not declared in this manifest and will not be removed.`,
+        hint: 'Run `uapkg list` to inspect currently declared dependencies.',
+        data: { packageName },
+    };
+}
+//# sourceMappingURL=ManifestDiagnostics.js.map

package/dist/manifest/ManifestDiagnostics.js.map

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

package/dist/pack/PackDiagnostics.d.ts

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

package/dist/pack/PackDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackDiagnostics.d.ts","sourceRoot":"","sources":["../../src/pack/PackDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM5D,iDAAiD;AACjD,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,gBAAgB,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtG,gDAAgD;AAChD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAC,sBAAsB,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEjH,qDAAqD;AACrD,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,cAAc,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElG,mDAAmD;AACnD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAC,uBAAuB,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE7G,2EAA2E;AAC3E,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,gBAAgB,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtG,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,aAAa,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhG,0DAA0D;AAC1D,MAAM,MAAM,yBAAyB,GAAG,cAAc,CAAC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAEnG,2DAA2D;AAC3D,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAC,sBAAsB,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEjH,qEAAqE;AACrE,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC,iBAAiB,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE1G,qCAAqC;AACrC,MAAM,MAAM,cAAc,GACtB,uBAAuB,GACvB,4BAA4B,GAC5B,qBAAqB,GACrB,4BAA4B,GAC5B,uBAAuB,GACvB,oBAAoB,GACpB,yBAAyB,GACzB,4BAA4B,GAC5B,wBAAwB,CAAC;AAM7B,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAOvF;AAED,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,MAAM,GAAG,4BAA4B,CAOjG;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAEnF;AAED,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,MAAM,GAAG,4BAA4B,CAQ5F;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAQvF;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAOjF;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,CAO3E;AAED,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,MAAM,GAAG,4BAA4B,CAOjG;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,wBAAwB,CAQ3F"}

package/dist/pack/PackDiagnostics.js

@@ -0,0 +1,74 @@
+// ---------------------------------------------------------------------------
+// Factory helpers
+// ---------------------------------------------------------------------------
+export function createCyclicSymlinkDiagnostic(filePath) {
+    return {
+        level: 'error',
+        code: 'CYCLIC_SYMLINK',
+        message: `Cyclic symlink detected at ${filePath}.`,
+        data: { filePath },
+    };
+}
+export function createSymlinkOutsideRootDiagnostic(filePath) {
+    return {
+        level: 'error',
+        code: 'SYMLINK_OUTSIDE_ROOT',
+        message: `Symlink resolves outside plugin root: ${filePath}.`,
+        data: { filePath },
+    };
+}
+export function createInvalidPathDiagnostic(filePath) {
+    return { level: 'error', code: 'INVALID_PATH', message: `Invalid normalized path: ${filePath}.`, data: { filePath } };
+}
+export function createPluginRootNotFoundDiagnostic(cwd) {
+    return {
+        level: 'error',
+        code: 'PLUGIN_ROOT_NOT_FOUND',
+        message: 'No uapkg.json found from current directory upward.',
+        hint: 'Run this command from within a uapkg project.',
+        data: { cwd },
+    };
+}
+export function createUnresolvedLfsDiagnostic(filePath) {
+    return {
+        level: 'error',
+        code: 'UNRESOLVED_LFS',
+        message: `Unresolved LFS pointer file: ${filePath}.`,
+        hint: "Run 'git lfs pull' or use --allow-missing-lfs.",
+        data: { filePath },
+    };
+}
+export function createLfsSkippedDiagnostic(filePath) {
+    return {
+        level: 'warning',
+        code: 'LFS_SKIPPED',
+        message: `Skipping unresolved LFS file: ${filePath}.`,
+        data: { filePath },
+    };
+}
+export function createNoFilesSelectedDiagnostic() {
+    return {
+        level: 'error',
+        code: 'NO_FILES_SELECTED',
+        message: 'No files selected for packing after ignore/LFS resolution.',
+        data: {},
+    };
+}
+export function createOutFileIsDirectoryDiagnostic(filePath) {
+    return {
+        level: 'error',
+        code: 'OUTFILE_IS_DIRECTORY',
+        message: '--outFile must be a file path, not a directory.',
+        data: { filePath },
+    };
+}
+export function createUpluginMissingDiagnostic(pluginRoot) {
+    return {
+        level: 'error',
+        code: 'UPLUGIN_MISSING',
+        message: `No plugin descriptor (*.uplugin) was found in "${pluginRoot}".`,
+        hint: 'Ensure your plugin root contains a .uplugin file before running `uapkg pack`.',
+        data: { pluginRoot },
+    };
+}
+//# sourceMappingURL=PackDiagnostics.js.map

package/dist/pack/PackDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackDiagnostics.js","sourceRoot":"","sources":["../../src/pack/PackDiagnostics.ts"],"names":[],"mappings":"AA6CA,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,8BAA8B,QAAQ,GAAG;QAClD,IAAI,EAAE,EAAE,QAAQ,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,QAAgB;IACjE,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,yCAAyC,QAAQ,GAAG;QAC7D,IAAI,EAAE,EAAE,QAAQ,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAgB;IAC1D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,4BAA4B,QAAQ,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC;AACxH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,GAAW;IAC5D,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,oDAAoD;QAC7D,IAAI,EAAE,+CAA+C;QACrD,IAAI,EAAE,EAAE,GAAG,EAAE;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gCAAgC,QAAQ,GAAG;QACpD,IAAI,EAAE,gDAAgD;QACtD,IAAI,EAAE,EAAE,QAAQ,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,iCAAiC,QAAQ,GAAG;QACrD,IAAI,EAAE,EAAE,QAAQ,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,4DAA4D;QACrE,IAAI,EAAE,EAAE;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,QAAgB;IACjE,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,iDAAiD;QAC1D,IAAI,EAAE,EAAE,QAAQ,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,UAAkB;IAC/D,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,kDAAkD,UAAU,IAAI;QACzE,IAAI,EAAE,+EAA+E;QACrF,IAAI,EAAE,EAAE,UAAU,EAAE;KACrB,CAAC;AACJ,CAAC"}

package/dist/postinstall/PostinstallDiagnostics.d.ts

@@ -0,0 +1,45 @@
+import type { DiagnosticBase } from '../base/Diagnostic.js';
+/** Postinstall was denied by policy (install.postInstallPolicy or per-registry override). */
+export 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). */
+export type PostinstallLoadFailedDiagnostic = DiagnosticBase<'POSTINSTALL_LOAD_FAILED', {
+    readonly packageName: string;
+    readonly entryFile: string;
+    readonly reason: string;
+}>;
+/** The postinstall module's default export failed Zod validation. */
+export 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). */
+export 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. */
+export type PostinstallMarkerCorruptDiagnostic = DiagnosticBase<'POSTINSTALL_MARKER_CORRUPT', {
+    readonly packageName: string;
+    readonly file: string;
+    readonly reason: string;
+}>;
+/** esbuild failed to transpile a `.ts` postinstall entry file. */
+export type PostinstallEsbuildErrorDiagnostic = DiagnosticBase<'POSTINSTALL_ESBUILD_ERROR', {
+    readonly packageName: string;
+    readonly entryFile: string;
+    readonly reason: string;
+}>;
+export type PostinstallDiagnostic = PostinstallPolicyDeniedDiagnostic | PostinstallLoadFailedDiagnostic | PostinstallInvalidExportDiagnostic | PostinstallDuplicateEntryDiagnostic | PostinstallMarkerCorruptDiagnostic | PostinstallEsbuildErrorDiagnostic;
+export declare function createPostinstallPolicyDeniedDiagnostic(packageName: string, registry: string, policy: 'allow' | 'deny', resolvedFrom: 'registry' | 'install'): PostinstallPolicyDeniedDiagnostic;
+export declare function createPostinstallLoadFailedDiagnostic(packageName: string, entryFile: string, reason: string): PostinstallLoadFailedDiagnostic;
+export declare function createPostinstallInvalidExportDiagnostic(packageName: string, entryFile: string, issues: readonly string[]): PostinstallInvalidExportDiagnostic;
+export declare function createPostinstallDuplicateEntryDiagnostic(packageName: string, candidates: readonly string[]): PostinstallDuplicateEntryDiagnostic;
+export declare function createPostinstallMarkerCorruptDiagnostic(packageName: string, file: string, reason: string): PostinstallMarkerCorruptDiagnostic;
+export declare function createPostinstallEsbuildErrorDiagnostic(packageName: string, entryFile: string, reason: string): PostinstallEsbuildErrorDiagnostic;
+//# sourceMappingURL=PostinstallDiagnostics.d.ts.map

package/dist/postinstall/PostinstallDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostinstallDiagnostics.d.ts","sourceRoot":"","sources":["../../src/postinstall/PostinstallDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM5D,6FAA6F;AAC7F,MAAM,MAAM,iCAAiC,GAAG,cAAc,CAC5D,2BAA2B,EAC3B;IACE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,UAAU,GAAG,SAAS,CAAC;CAC/C,CACF,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,+BAA+B,GAAG,cAAc,CAC1D,yBAAyB,EACzB;IACE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CACF,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,kCAAkC,GAAG,cAAc,CAC7D,4BAA4B,EAC5B;IACE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CACF,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,mCAAmC,GAAG,cAAc,CAC9D,6BAA6B,EAC7B;IACE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CACF,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,kCAAkC,GAAG,cAAc,CAC7D,4BAA4B,EAC5B;IACE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CACF,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,iCAAiC,GAAG,cAAc,CAC5D,2BAA2B,EAC3B;IACE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CACF,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,iCAAiC,GACjC,+BAA+B,GAC/B,kCAAkC,GAClC,mCAAmC,GACnC,kCAAkC,GAClC,iCAAiC,CAAC;AAMtC,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GAAG,MAAM,EACxB,YAAY,EAAE,UAAU,GAAG,SAAS,GACnC,iCAAiC,CAWnC;AAED,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,+BAA+B,CAOjC;AAED,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,kCAAkC,CAQpC;AAED,wBAAgB,yCAAyC,CACvD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,mCAAmC,CAQrC;AAED,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,kCAAkC,CAQpC;AAED,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,iCAAiC,CAQnC"}

package/dist/postinstall/PostinstallDiagnostics.js

@@ -0,0 +1,59 @@
+// ---------------------------------------------------------------------------
+// Factories
+// ---------------------------------------------------------------------------
+export function createPostinstallPolicyDeniedDiagnostic(packageName, registry, policy, resolvedFrom) {
+    return {
+        level: 'info',
+        code: 'POSTINSTALL_POLICY_DENIED',
+        message: `Postinstall skipped for "${packageName}" (policy=${policy}, from ${resolvedFrom}).`,
+        hint: resolvedFrom === 'registry'
+            ? `Override per-registry via \`registries.${registry}.postInstallPolicy = "allow"\`.`
+            : 'Override globally via `install.postInstallPolicy = "allow"` in your uapkg config.',
+        data: { packageName, registry, policy, resolvedFrom },
+    };
+}
+export function createPostinstallLoadFailedDiagnostic(packageName, entryFile, reason) {
+    return {
+        level: 'error',
+        code: 'POSTINSTALL_LOAD_FAILED',
+        message: `Failed to load postinstall for "${packageName}" from "${entryFile}": ${reason}.`,
+        data: { packageName, entryFile, reason },
+    };
+}
+export function createPostinstallInvalidExportDiagnostic(packageName, entryFile, issues) {
+    return {
+        level: 'error',
+        code: 'POSTINSTALL_INVALID_EXPORT',
+        message: `Postinstall default export for "${packageName}" is invalid.`,
+        hint: 'Use `definePostinstall({...})` and export the result as default.',
+        data: { packageName, entryFile, issues },
+    };
+}
+export function createPostinstallDuplicateEntryDiagnostic(packageName, candidates) {
+    return {
+        level: 'error',
+        code: 'POSTINSTALL_DUPLICATE_ENTRY',
+        message: `Multiple postinstall entry files found for "${packageName}".`,
+        hint: 'Keep only one of `.uapkg/postinstall.ts|.js|.mjs`.',
+        data: { packageName, candidates },
+    };
+}
+export function createPostinstallMarkerCorruptDiagnostic(packageName, file, reason) {
+    return {
+        level: 'error',
+        code: 'POSTINSTALL_MARKER_CORRUPT',
+        message: `Postinstall marker block corrupt in "${file}" for "${packageName}": ${reason}.`,
+        hint: 'Restore the UAPKG-BEGIN/END markers or remove them manually and re-run.',
+        data: { packageName, file, reason },
+    };
+}
+export function createPostinstallEsbuildErrorDiagnostic(packageName, entryFile, reason) {
+    return {
+        level: 'error',
+        code: 'POSTINSTALL_ESBUILD_ERROR',
+        message: `esbuild failed on "${entryFile}" for "${packageName}": ${reason}.`,
+        hint: 'Note: uapkg transpiles but does not type-check; fix the file in your IDE.',
+        data: { packageName, entryFile, reason },
+    };
+}
+//# sourceMappingURL=PostinstallDiagnostics.js.map

package/dist/postinstall/PostinstallDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostinstallDiagnostics.js","sourceRoot":"","sources":["../../src/postinstall/PostinstallDiagnostics.ts"],"names":[],"mappings":"AA0EA,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,UAAU,uCAAuC,CACrD,WAAmB,EACnB,QAAgB,EAChB,MAAwB,EACxB,YAAoC;IAEpC,OAAO;QACL,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,4BAA4B,WAAW,aAAa,MAAM,UAAU,YAAY,IAAI;QAC7F,IAAI,EACF,YAAY,KAAK,UAAU;YACzB,CAAC,CAAC,0CAA0C,QAAQ,iCAAiC;YACrF,CAAC,CAAC,mFAAmF;QACzF,IAAI,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE;KACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,WAAmB,EACnB,SAAiB,EACjB,MAAc;IAEd,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,mCAAmC,WAAW,WAAW,SAAS,MAAM,MAAM,GAAG;QAC1F,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,WAAmB,EACnB,SAAiB,EACjB,MAAyB;IAEzB,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,4BAA4B;QAClC,OAAO,EAAE,mCAAmC,WAAW,eAAe;QACtE,IAAI,EAAE,kEAAkE;QACxE,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,WAAmB,EACnB,UAA6B;IAE7B,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,6BAA6B;QACnC,OAAO,EAAE,+CAA+C,WAAW,IAAI;QACvE,IAAI,EAAE,oDAAoD;QAC1D,IAAI,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,WAAmB,EACnB,IAAY,EACZ,MAAc;IAEd,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,4BAA4B;QAClC,OAAO,EAAE,wCAAwC,IAAI,UAAU,WAAW,MAAM,MAAM,GAAG;QACzF,IAAI,EAAE,yEAAyE;QAC/E,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,WAAmB,EACnB,SAAiB,EACjB,MAAc;IAEd,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,sBAAsB,SAAS,UAAU,WAAW,MAAM,MAAM,GAAG;QAC5E,IAAI,EAAE,2EAA2E;QACjF,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE;KACzC,CAAC;AACJ,CAAC"}

package/dist/registry/RegistryDiagnostics.d.ts

@@ -0,0 +1,56 @@
+import type { DiagnosticBase } from '../base/Diagnostic.js';
+/** A network-level error when communicating with a registry. */
+export type NetworkErrorDiagnostic = DiagnosticBase<'NETWORK_ERROR', {
+    readonly url: string;
+    readonly reason: string;
+}>;
+/** A git operation failed. */
+export type GitErrorDiagnostic = DiagnosticBase<'GIT_ERROR', {
+    readonly command: string;
+    readonly stderr: string;
+    readonly exitCode: number;
+}>;
+/** A registry document did not pass schema validation. */
+export type SchemaInvalidDiagnostic = DiagnosticBase<'SCHEMA_INVALID', {
+    readonly filePath: string;
+    readonly issues: readonly string[];
+}>;
+/** A referenced registry name is not found in configuration. */
+export type RegistryNotFoundDiagnostic = DiagnosticBase<'REGISTRY_NOT_FOUND', {
+    readonly registryName: string;
+}>;
+/** Failed to acquire the registry update lock. */
+export type LockAcquisitionFailedDiagnostic = DiagnosticBase<'LOCK_ACQUISITION_FAILED', {
+    readonly lockPath: string;
+    readonly ownerPid: number;
+}>;
+/** Registry cache could not be read. */
+export type CacheReadErrorDiagnostic = DiagnosticBase<'CACHE_READ_ERROR', {
+    readonly cachePath: string;
+    readonly reason: string;
+}>;
+/** Registry could not be reached, optionally with cached state available. */
+export type RegistryUnreachableDiagnostic = DiagnosticBase<'REGISTRY_UNREACHABLE', {
+    readonly registryName: string;
+    readonly url: string;
+    readonly httpStatus?: number;
+    readonly cause: string;
+    readonly initialized: boolean;
+}>;
+/** Union of all registry diagnostics. */
+export type RegistryDiagnostic = NetworkErrorDiagnostic | GitErrorDiagnostic | SchemaInvalidDiagnostic | RegistryNotFoundDiagnostic | LockAcquisitionFailedDiagnostic | CacheReadErrorDiagnostic | RegistryUnreachableDiagnostic;
+export declare function createNetworkErrorDiagnostic(url: string, reason: string): NetworkErrorDiagnostic;
+export declare function createGitErrorDiagnostic(command: string, stderr: string, exitCode: number): GitErrorDiagnostic;
+export declare function createSchemaInvalidDiagnostic(filePath: string, issues: readonly string[]): SchemaInvalidDiagnostic;
+export declare function createRegistryNotFoundDiagnostic(registryName: string): RegistryNotFoundDiagnostic;
+export declare function createLockAcquisitionFailedDiagnostic(lockPath: string, ownerPid: number): LockAcquisitionFailedDiagnostic;
+export declare function createCacheReadErrorDiagnostic(cachePath: string, reason: string): CacheReadErrorDiagnostic;
+export declare function createRegistryUnreachableDiagnostic(input: {
+    readonly registryName: string;
+    readonly url: string;
+    readonly cause: string;
+    readonly initialized: boolean;
+    readonly httpStatus?: number;
+    readonly level?: 'error' | 'warning';
+}): RegistryUnreachableDiagnostic;
+//# sourceMappingURL=RegistryDiagnostics.d.ts.map

package/dist/registry/RegistryDiagnostics.d.ts.map

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