@agentxm/client-core 0.1.6

package/dist/src/unstable/registry/error-mapping.js

@@ -0,0 +1,307 @@
+/**
+ * Shared error mapping helpers for registry and auth client implementations.
+ *
+ * Provides reusable predicates and mappers for converting generated client
+ * errors (RegistryClientError, HttpClientError, SchemaError) to AppError.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as HttpClientError from "effect/unstable/http/HttpClientError";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import { makeAppError } from "../app-error/index.js";
+import { isLoopbackAddress } from "../utils/index.js";
+// -----------------------------------------------------------------------------
+// Safe Field Access
+// -----------------------------------------------------------------------------
+/**
+ * Safely read a string field from an unknown object.
+ */
+export const getString = (obj, field) => {
+    if (obj === null || obj === undefined || typeof obj !== "object")
+        return undefined;
+    const value = Reflect.get(obj, field);
+    return typeof value === "string" ? value : undefined;
+};
+/**
+ * Safely read a number field from an unknown object.
+ */
+const getNumber = (obj, field) => {
+    if (obj === null || obj === undefined || typeof obj !== "object")
+        return undefined;
+    const value = Reflect.get(obj, field);
+    return typeof value === "number" ? value : undefined;
+};
+/**
+ * Safely read an object field from an unknown object.
+ */
+const getObject = (obj, field) => {
+    if (obj === null || obj === undefined || typeof obj !== "object")
+        return undefined;
+    const value = Reflect.get(obj, field);
+    return value !== null && value !== undefined && typeof value === "object" ? value : undefined;
+};
+/**
+ * Safely read an array of strings from an unknown object field.
+ */
+const getStringArray = (obj, field) => {
+    if (obj === null || obj === undefined || typeof obj !== "object")
+        return undefined;
+    const value = Reflect.get(obj, field);
+    return Array.isArray(value) ? value.filter((v) => typeof v === "string") : undefined;
+};
+// -----------------------------------------------------------------------------
+// RegistryClientError Predicate
+// -----------------------------------------------------------------------------
+/**
+ * Create a type predicate that matches a specific RegistryClientError tag.
+ *
+ * Usage:
+ * ```ts
+ * Effect.catchIf(isRegistryClientError("ExtensionsGet404"), ...)
+ * ```
+ */
+export const isRegistryClientError = (tag) => (e) => Predicate.isTagged(e, tag);
+// -----------------------------------------------------------------------------
+// HttpClientError Predicate
+// -----------------------------------------------------------------------------
+/**
+ * Type predicate for HttpClientError.
+ */
+export const isHttpClientError = (e) => HttpClientError.isHttpClientError(e);
+/**
+ * Type predicate matching HttpClientErrors that are reasonable to retry:
+ * transport-level failures (ECONNREFUSED, DNS, etc.) and 5xx status codes.
+ * Deterministic failures — encode errors, invalid URLs, decode errors,
+ * 4xx statuses — are excluded so they fail fast.
+ */
+export const isTransientHttpClientError = (e) => {
+    if (!HttpClientError.isHttpClientError(e))
+        return false;
+    const reason = e.reason;
+    if (reason._tag === "TransportError")
+        return true;
+    if (reason._tag === "StatusCodeError" && reason.response.status >= 500)
+        return true;
+    return false;
+};
+/**
+ * Type predicate for SchemaError from effect/Schema.
+ */
+export const isSchemaError = (e) => e !== null && e !== undefined && typeof e === "object" && "_tag" in e && e._tag === "SchemaError";
+// -----------------------------------------------------------------------------
+// Network Diagnostics
+// -----------------------------------------------------------------------------
+/**
+ * Build a user-facing howToFix message for network errors.
+ * Detects localhost+HTTPS mismatches and provides targeted guidance.
+ */
+export const buildNetworkHowToFix = (baseUrl) => {
+    const fallback = "Check registry URL/network connectivity and retry.";
+    try {
+        const parsed = new URL(baseUrl);
+        const isLocalAddr = isLoopbackAddress(parsed.hostname);
+        if (isLocalAddr && parsed.protocol === "https:") {
+            return "Ensure local registry is running with TLS, or switch the source URL to http://localhost:<port>.";
+        }
+        if (isLocalAddr) {
+            return "Ensure local registry is running and reachable at the configured host/port.";
+        }
+        return fallback;
+    }
+    catch {
+        return fallback;
+    }
+};
+/**
+ * Build diagnostic details array for network errors.
+ * Detects localhost+HTTPS protocol mismatch.
+ */
+export const buildNetworkDiagnosis = (baseUrl) => {
+    try {
+        const parsed = new URL(baseUrl);
+        const isLocalAddr = isLoopbackAddress(parsed.hostname);
+        if (isLocalAddr && parsed.protocol === "https:") {
+            return ["Diagnosis: Local registry appears HTTP-only while source uses HTTPS."];
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+};
+// -----------------------------------------------------------------------------
+// Tag Utilities
+// -----------------------------------------------------------------------------
+/**
+ * Safely read the _tag from an unknown value.
+ */
+export const getTag = (e) => getString(e, "_tag");
+/**
+ * Check if an unknown value is a RegistryClientError (has _tag, request, response fields).
+ */
+export const isAnyRegistryClientError = (e) => e !== null &&
+    e !== undefined &&
+    typeof e === "object" &&
+    "_tag" in e &&
+    "response" in e &&
+    "request" in e;
+/**
+ * Check if an unknown value has a _tag ending with the given suffix.
+ */
+export const hasTagSuffix = (e, suffix) => {
+    const tag = getTag(e);
+    return tag !== undefined && tag.endsWith(suffix);
+};
+// -----------------------------------------------------------------------------
+// Auth Error Mapping
+// -----------------------------------------------------------------------------
+/**
+ * Map a 401 RegistryClientError to an AUTH_UNAUTHENTICATED AppError.
+ * Extracts details from the typed cause when available.
+ */
+export const mapAuthUnauthenticated = (error, howToFix) => {
+    const details = [];
+    const detail = getString(error.cause, "detail");
+    if (detail !== undefined) {
+        details.push(detail);
+    }
+    return makeAppError({
+        code: "AUTH_UNAUTHENTICATED",
+        what: "Authentication required",
+        details,
+        howToFix: howToFix ?? "Run `axm login` to sign in.",
+        cause: error,
+    });
+};
+/**
+ * Map a 403 RegistryClientError to an AUTH_UNAUTHORIZED AppError.
+ * Extracts required_scope, token_scopes, required_role from typed cause details.
+ */
+export const mapAuthUnauthorized = (error) => {
+    const details = [];
+    const cause = error.cause;
+    const detail = getString(cause, "detail");
+    if (detail !== undefined) {
+        details.push(detail);
+    }
+    const causeDetails = getObject(cause, "details");
+    if (causeDetails !== undefined) {
+        const requiredScope = getString(causeDetails, "requiredScope");
+        if (requiredScope !== undefined) {
+            details.push(`Required scope: ${requiredScope}`);
+        }
+        const tokenScopes = getStringArray(causeDetails, "tokenScopes");
+        if (tokenScopes !== undefined) {
+            details.push(`Token scopes: ${tokenScopes.join(", ")}`);
+        }
+        const grantedScopes = getStringArray(causeDetails, "grantedScopes");
+        if (grantedScopes !== undefined) {
+            details.push(`Granted scopes: ${grantedScopes.join(", ")}`);
+        }
+        const requiredRole = getString(causeDetails, "requiredRole");
+        if (requiredRole !== undefined) {
+            details.push(`Required role: ${requiredRole}`);
+        }
+    }
+    return makeAppError({
+        code: "AUTH_UNAUTHORIZED",
+        what: "Insufficient permissions",
+        details,
+        howToFix: "You do not have permission for this operation. Check your account permissions.",
+        cause: error,
+    });
+};
+// -----------------------------------------------------------------------------
+// Network Error Mapping
+// -----------------------------------------------------------------------------
+/**
+ * Map an HttpClientError to an AppError with network error codes.
+ */
+export const mapNetworkError = (error, code, what, baseUrl) => makeAppError({
+    code,
+    what,
+    details: [...buildNetworkDiagnosis(baseUrl), error.message],
+    howToFix: buildNetworkHowToFix(baseUrl),
+    cause: error,
+});
+// -----------------------------------------------------------------------------
+// Schema Error Mapping
+// -----------------------------------------------------------------------------
+/**
+ * Map a Schema decode error to an AppError.
+ */
+export const mapSchemaError = (error, code, what) => makeAppError({
+    code,
+    what,
+    details: (() => {
+        const msg = getString(error, "message");
+        return msg !== undefined ? [msg] : [];
+    })(),
+    cause: error,
+});
+// -----------------------------------------------------------------------------
+// Generic Error Mapping
+// -----------------------------------------------------------------------------
+/**
+ * Map a RegistryClientError to an AppError for unexpected status codes.
+ */
+export const mapUnexpectedStatusError = (error, code, what) => {
+    const details = [];
+    const cause = error.cause;
+    const detail = getString(cause, "detail");
+    if (detail !== undefined) {
+        details.push(detail);
+    }
+    const errorCode = getString(cause, "code");
+    if (errorCode !== undefined) {
+        details.push(`Error code: ${errorCode}`);
+    }
+    return makeAppError({
+        code,
+        what,
+        details,
+        cause: error,
+    });
+};
+// -----------------------------------------------------------------------------
+// Publish Error Mapping
+// -----------------------------------------------------------------------------
+/**
+ * Extract the `code` field from a RegistryClientError cause.
+ */
+export const getErrorCode = (error) => {
+    const code = getString(error.cause, "code");
+    return Option.fromUndefinedOr(code);
+};
+/**
+ * Build details array from a RegistryClientError cause.
+ */
+export const buildErrorDetails = (error) => {
+    const details = [];
+    const cause = error.cause;
+    const detail = getString(cause, "detail");
+    if (detail !== undefined) {
+        details.push(detail);
+    }
+    const requestId = getString(cause, "requestId");
+    if (requestId !== undefined) {
+        details.push(`Request ID: ${requestId}`);
+    }
+    return details;
+};
+/**
+ * Extract retryAfterSeconds from a RegistryClientError cause details.
+ */
+export const getRetryAfterSeconds = (error) => {
+    const causeDetails = getObject(error.cause, "details");
+    if (causeDetails !== undefined) {
+        const retryAfter = getNumber(causeDetails, "retryAfterSeconds");
+        if (retryAfter !== undefined) {
+            return Option.some(retryAfter);
+        }
+    }
+    return Option.none();
+};
+//# sourceMappingURL=error-mapping.js.map

package/dist/src/unstable/registry/error-mapping.js.map

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

package/dist/src/unstable/registry/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Registry feature module.
+ *
+ * Provides schema definitions for registry layout including extension index
+ * metadata and version entries, client types, and shared utilities.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export type { ExtensionIndex, VersionEntry } from "./schema.js";
+export { ExtensionIndexSchema, VersionEntrySchema } from "./schema.js";
+export type { DiscoverExtensionEntry, DiscoverExtensionsResponse } from "./discover-schema.js";
+export { DiscoverExtensionEntrySchema, DiscoverExtensionsResponseSchema, } from "./discover-schema.js";
+export type { RegistryClient, RegistryExtensionManifest, DiscoverExtensionsArgs, GetExtensionsByOwnerArgs, GetExtensionsByOwnerResponse, GetExtensionIndexArgs, GetExtensionPackageArgs, GetExtensionPackageResponse, PublishExtensionArgs, PublishExtensionResponse, OwnerExistsResponse, ExtensionExistsArgs, ExtensionExistsResponse, } from "./client.js";
+export { createRegistryClient } from "./client.js";
+export { createLocalRegistryClient } from "./local-client.js";
+export { createRemoteRegistryClient } from "./remote-client.js";
+export { buildNetworkHowToFix, buildNetworkDiagnosis, isRegistryClientError, isHttpClientError, isSchemaError, mapAuthUnauthenticated, mapAuthUnauthorized, mapNetworkError, mapSchemaError, mapUnexpectedStatusError, getErrorCode, buildErrorDetails, getRetryAfterSeconds, } from "./error-mapping.js";
+export { extensionDir, extractZip, pluralizeType, resolveVersionEntry, selectVersion, } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGvE,YAAY,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/src/unstable/registry/index.js

@@ -0,0 +1,21 @@
+/**
+ * Registry feature module.
+ *
+ * Provides schema definitions for registry layout including extension index
+ * metadata and version entries, client types, and shared utilities.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { ExtensionIndexSchema, VersionEntrySchema } from "./schema.js";
+export { DiscoverExtensionEntrySchema, DiscoverExtensionsResponseSchema, } from "./discover-schema.js";
+export { createRegistryClient } from "./client.js";
+// Local client
+export { createLocalRegistryClient } from "./local-client.js";
+// Remote client
+export { createRemoteRegistryClient } from "./remote-client.js";
+// Error mapping helpers
+export { buildNetworkHowToFix, buildNetworkDiagnosis, isRegistryClientError, isHttpClientError, isSchemaError, mapAuthUnauthenticated, mapAuthUnauthorized, mapNetworkError, mapSchemaError, mapUnexpectedStatusError, getErrorCode, buildErrorDetails, getRetryAfterSeconds, } from "./error-mapping.js";
+// Utilities
+export { extensionDir, extractZip, pluralizeType, resolveVersionEntry, selectVersion, } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIvE,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,sBAAsB,CAAC;AAkB9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAe;AACf,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,gBAAgB;AAChB,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,wBAAwB;AACxB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/src/unstable/registry/local-client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Local filesystem-backed registry client.
+ *
+ * All operations read/write files relative to a registry root using the
+ * layout: `<root>/extensions/@<owner>/<type>/<name>/`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import type { RegistryClient } from "./client.js";
+/**
+ * Creates a local filesystem-backed registry client.
+ *
+ * All operations read/write files relative to `registryRoot` using the
+ * registry layout: `<root>/extensions/@<owner>/<type>/<name>/`.
+ *
+ * @param registryRoot - Absolute path to the registry root directory
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const createLocalRegistryClient: (registryRoot: string, fs: FileSystem.FileSystem, path: Path.Path) => RegistryClient;
+//# sourceMappingURL=local-client.d.ts.map

package/dist/src/unstable/registry/local-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-client.d.ts","sourceRoot":"","sources":["../../../../src/unstable/registry/local-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AAOzC,OAAO,KAAK,EACV,cAAc,EAOf,MAAM,aAAa,CAAC;AA4KrB;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACpC,cAAc,MAAM,EACpB,IAAI,UAAU,CAAC,UAAU,EACzB,MAAM,IAAI,CAAC,IAAI,KACd,cA6SD,CAAC"}