@zarel-ai/sdk 0.6.0

package/dist/errors.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZarelTimeoutError = exports.ZarelAuthError = exports.ZarelAPIError = exports.ZarelError = void 0;
+/**
+ * Base error class for all Zarel SDK errors.
+ */
+class ZarelError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ZarelError';
+    }
+}
+exports.ZarelError = ZarelError;
+/**
+ * Thrown when the API returns a non-2xx response.
+ * Contains the structured error envelope from the server.
+ */
+class ZarelAPIError extends ZarelError {
+    status;
+    type;
+    code;
+    requestId;
+    field;
+    /**
+     * Non-standard top-level fields of the error body (everything except the
+     * canonical `error` envelope). Lets endpoints attach structured recovery
+     * data alongside the error — e.g. the contract-assistant apply 409
+     * `contract_hash_mismatch` carries `reseeded_changeset_id` + `base_hash`
+     * (FR-024) so a client recovers the re-seeded handle without parsing prose.
+     */
+    details;
+    /**
+     * The confirmation challenge from a `409 confirmation_required` (ADR-0127
+     * US3) — every `confirm` guard that paused this write plus the ONE consent
+     * token bound to the whole set.
+     *
+     * Its own field rather than part of `details` because it rides INSIDE the
+     * `error` envelope, which `details` deliberately excludes. Present only when
+     * the server sent a complete challenge; a caller that renders every
+     * `guards[]` prompt and re-sends the IDENTICAL request with
+     * `confirmationToken: challenge.token` proceeds.
+     */
+    confirmation;
+    constructor(status, type, code, message, requestId, field, details, confirmation) {
+        super(message);
+        this.name = 'ZarelAPIError';
+        this.status = status;
+        this.type = type;
+        this.code = code;
+        this.requestId = requestId;
+        this.field = field;
+        this.details = details;
+        this.confirmation = confirmation;
+    }
+}
+exports.ZarelAPIError = ZarelAPIError;
+/**
+ * Thrown when authentication fails (missing token, expired, invalid)
+ * or when a namespace method is invoked without its plane token configured.
+ */
+class ZarelAuthError extends ZarelError {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'ZarelAuthError';
+        this.code = code;
+    }
+}
+exports.ZarelAuthError = ZarelAuthError;
+/**
+ * Thrown when a request times out.
+ */
+class ZarelTimeoutError extends ZarelError {
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.name = 'ZarelTimeoutError';
+    }
+}
+exports.ZarelTimeoutError = ZarelTimeoutError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,UAAW,SAAQ,KAAK;IACjC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7B,CAAC;CACJ;AALD,gCAKC;AAED;;;GAGG;AACH,MAAa,aAAc,SAAQ,UAAU;IAChC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,IAAI,CAAS;IACb,SAAS,CAAqB;IAC9B,KAAK,CAAqB;IACnC;;;;;;OAMG;IACM,OAAO,CAAgD;IAChE;;;;;;;;;;OAUG;IACM,YAAY,CAAoC;IAEzD,YACI,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,OAAe,EACf,SAAkB,EAClB,KAAc,EACd,OAA2C,EAC3C,YAAoC;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;CACJ;AA/CD,sCA+CC;AAiBD;;;GAGG;AACH,MAAa,cAAe,SAAQ,UAAU;IACjC,IAAI,CAAqB;IAElC,YAAY,OAAe,EAAE,IAAwB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AARD,wCAQC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,UAAU;IAC7C,YAAY,SAAiB;QACzB,KAAK,CAAC,2BAA2B,SAAS,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ;AALD,8CAKC"}