@syndroo/sdk 0.4.0-rc.1 → 0.7.0

package/dist/errors.d.ts

@@ -1,104 +1,59 @@
 /**
- * Typed error hierarchy for the public Syndroo SDK.
+ * Error surface of `@syndroo/sdk`.
  *
- * Every failure the SDK raises is a `SyndrooError`, so callers can narrow on
- * one base class and still classify the outcome precisely. The
- * `requestMayHaveBeenApplied` flag is the state that decides whether a resend
- * is safe: it is true whenever a write may already have reached Syndroo, which
- * is exactly the case where retrying with a new idempotency key could create a
- * second post.
+ * Every error the SDK raises carries a stable `code` and a fixed message. The
+ * message never contains a base URL, a path, an idempotency key, a bearer token
+ * or any part of a server response, because SDK errors reach logs. The only
+ * server-authored data that can appear is `serverError`, and only after the
+ * envelope that carried it passed the generated wire validator.
+ *
+ * A validated envelope is not enough on its own: the wire schema legitimately
+ * allows arbitrary `code`/`message` strings and tolerates extra fields, so the
+ * server object is never stored by reference. `projectServerError` copies it
+ * onto a fixed shape - an allowlisted code, a static message and bounded
+ * `details` values - so no server-authored text can reach a log through
+ * `JSON.stringify`, `util.inspect` or a stack trace.
  */
-import type { PostDetail } from "./types.js";
-export type SyndrooErrorCode = "CONFIG" | "VALIDATION" | "ABORTED" | "TIMEOUT" | "NETWORK" | "INVALID_RESPONSE" | "WAIT_TIMEOUT" | (string & {});
-export interface SyndrooErrorInit {
-    cause?: unknown | undefined;
-    requestMayHaveBeenApplied?: boolean | undefined;
-}
-export declare class SyndrooError<Code extends SyndrooErrorCode = SyndrooErrorCode> extends Error {
-    readonly code: Code;
-    readonly requestMayHaveBeenApplied: boolean;
-    constructor(message: string, init: SyndrooErrorInit & {
-        code: Code;
-    });
-}
-/** The client configuration itself is unusable, so no request was sent. */
-export declare class SyndrooConfigError extends SyndrooError<"CONFIG"> {
-    constructor(message: string);
-}
-/** The caller's argument cannot become a valid Syndroo request. */
-export declare class SyndrooValidationError extends SyndrooError<"VALIDATION"> {
-    constructor(message: string);
-}
-/** The caller aborted through an AbortSignal. */
-export declare class SyndrooAbortError extends SyndrooError<"ABORTED"> {
-    constructor(message: string, init?: SyndrooErrorInit);
-}
-/** The configured deadline elapsed before the response was received. */
-export declare class SyndrooTimeoutError extends SyndrooError<"TIMEOUT"> {
-    readonly timeoutMs: number;
-    constructor(message: string, init: SyndrooErrorInit & {
-        timeoutMs: number;
-    });
-}
+import type { SafeError } from "./types.js";
 /**
- * The request never produced an HTTP response. `networkCode` carries the
- * runtime's error code, such as `ECONNREFUSED`, when one is available.
+ * Project a server-authored error onto a fixed, allowlisted shape.
+ *
+ * Only three fields survive, each of them validated: an allowlisted `code` (an
+ * unrecognized code becomes `UNKNOWN_ERROR`), a static `message`, and `details`
+ * rebuilt from scratch so unknown keys, wrong types and malformed values are
+ * dropped. Nothing is copied by reference, so mutating the original object
+ * afterwards cannot change what an error reports.
  */
-export declare class SyndrooNetworkError extends SyndrooError<"NETWORK"> {
-    readonly networkCode?: string;
-    constructor(message: string, init: SyndrooErrorInit & {
-        networkCode?: string | undefined;
-    });
-}
+export declare function projectServerError(raw: unknown): SafeError | undefined;
+/** Stable, branchable error codes. Adding one is an API decision. */
+export type SyndrooErrorCode = "INVALID_ARGUMENT" | "INSECURE_BASE_URL" | "INVALID_REQUEST" | "INVALID_RESPONSE" | "RESPONSE_TOO_LARGE" | "REDIRECT_NOT_ALLOWED" | "TRANSPORT" | "HTTP_ERROR" | "PROTOCOL" | "TIMEOUT" | "ABORTED" | "WAIT_TIMEOUT" | "CONFIRMATION_REQUIRED" | "CONFIRMATION_EXPIRED";
+export type SyndrooErrorInit = {
+    /** HTTP status, when the error came from a response. Never a response body. */
+    status?: number;
+    /**
+     * `SafeError` from an `ok:false` envelope, or any object meant to stand in
+     * for one. It is projected onto the allowlisted shape, never stored as-is.
+     */
+    serverError?: SafeError;
+    /**
+     * Whether the SDK considers a same-key transport retry safe for this failure.
+     * Defaults to true for a bare transport failure and false otherwise.
+     */
+    retryable?: boolean;
+};
 /**
- * Syndroo answered, but the answer is not the documented JSON contract: a
- * non-JSON body, a missing required field, or a body above the configured
- * size limit. The outcome of a write is never inferred from a bad response.
+ * One error type for transport, protocol and local-cancellation failures.
+ *
+ * `retryable` describes the SDK's own transport-retry decision for this failure
+ * and is never advice to retry content: an `unknown` business outcome is a
+ * successful protocol call, not an error, and is never auto-retried.
  */
-export declare class SyndrooResponseError extends SyndrooError<"INVALID_RESPONSE"> {
+export declare class SyndrooError extends Error {
+    readonly code: SyndrooErrorCode;
     readonly status?: number;
-    readonly preview?: string;
-    constructor(message: string, init?: SyndrooErrorInit & {
-        status?: number | undefined;
-        preview?: string | undefined;
-    });
-}
-/**
- * Syndroo rejected the request with a documented error envelope. `code` is the
- * server's code such as `UNAUTHORIZED`, `POST_NOT_FOUND`,
- * `IDEMPOTENCY_CONFLICT`, or `PLATFORM_NOT_CONFIGURED`, and `HTTP_<status>`
- * when the body did not carry one.
- */
-export declare class SyndrooApiError extends SyndrooError {
-    readonly status: number;
-    readonly retryAfterMs?: number;
-    constructor(message: string, init: SyndrooErrorInit & {
-        code: SyndrooErrorCode;
-        status: number;
-        retryAfterMs?: number | undefined;
-    });
-    /** Syndroo or an intermediary asked the client to slow down. */
-    get retryable(): boolean;
-}
-/** `posts.wait` reached its deadline before the post became terminal. */
-export declare class SyndrooWaitTimeoutError extends SyndrooError<"WAIT_TIMEOUT"> {
-    readonly postId: string;
-    readonly timeoutMs: number;
-    readonly lastStatus?: string;
-    readonly lastPost?: PostDetail;
-    readonly lastError?: SyndrooError;
-    constructor(message: string, init: {
-        postId: string;
-        timeoutMs: number;
-        lastStatus?: string | undefined;
-        lastPost?: PostDetail | undefined;
-        lastError?: SyndrooError | undefined;
-    });
+    readonly serverError?: SafeError;
+    readonly retryable: boolean;
+    constructor(code: SyndrooErrorCode, init?: SyndrooErrorInit);
 }
 export declare function isSyndrooError(value: unknown): value is SyndrooError;
-/**
- * Internal helper for bounded diagnostics. Error messages and response
- * previews must never grow with the size of an untrusted body.
- */
-export declare function truncate(value: string, limit: number): string;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyE5C;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAgBtE;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,WAAW,GACX,YAAY,GACZ,UAAU,GACV,SAAS,GACT,SAAS,GACT,cAAc,GACd,uBAAuB,GACvB,sBAAsB,CAAC;AAoB3B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,YAAY,IAAI,EAAE,gBAAgB,EAAE,IAAI,GAAE,gBAAqB,EAc9D;CACF;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/errors.js

@@ -1,162 +1,156 @@
 /**
- * Typed error hierarchy for the public Syndroo SDK.
+ * Error surface of `@syndroo/sdk`.
  *
- * Every failure the SDK raises is a `SyndrooError`, so callers can narrow on
- * one base class and still classify the outcome precisely. The
- * `requestMayHaveBeenApplied` flag is the state that decides whether a resend
- * is safe: it is true whenever a write may already have reached Syndroo, which
- * is exactly the case where retrying with a new idempotency key could create a
- * second post.
+ * Every error the SDK raises carries a stable `code` and a fixed message. The
+ * message never contains a base URL, a path, an idempotency key, a bearer token
+ * or any part of a server response, because SDK errors reach logs. The only
+ * server-authored data that can appear is `serverError`, and only after the
+ * envelope that carried it passed the generated wire validator.
+ *
+ * A validated envelope is not enough on its own: the wire schema legitimately
+ * allows arbitrary `code`/`message` strings and tolerates extra fields, so the
+ * server object is never stored by reference. `projectServerError` copies it
+ * onto a fixed shape - an allowlisted code, a static message and bounded
+ * `details` values - so no server-authored text can reach a log through
+ * `JSON.stringify`, `util.inspect` or a stack trace.
  */
-export class SyndrooError extends Error {
-    code;
-    requestMayHaveBeenApplied;
-    constructor(message, init) {
-        super(message, { cause: init.cause });
-        this.name = "SyndrooError";
-        this.code = init.code;
-        this.requestMayHaveBeenApplied = init.requestMayHaveBeenApplied ?? false;
-    }
-}
-/** The client configuration itself is unusable, so no request was sent. */
-export class SyndrooConfigError extends SyndrooError {
-    constructor(message) {
-        super(message, { code: "CONFIG" });
-        this.name = "SyndrooConfigError";
+/**
+ * Protocol error codes the server may report verbatim (the stable set from the
+ * shared blueprint). A code outside this set is never retained.
+ */
+const SERVER_ERROR_CODES = new Set([
+    "INVALID_INPUT",
+    "BODY_TOO_LARGE",
+    "UNSUPPORTED_MEDIA_TYPE",
+    "UNAUTHORIZED",
+    "FORBIDDEN",
+    "NOT_FOUND",
+    "TARGET_AMBIGUOUS",
+    "DUPLICATE_TARGET",
+    "CONNECTION_IDENTITY_CHANGED",
+    "CONNECTION_CAPACITY",
+    "PROVIDER_TRUST_REQUIRED",
+    "PROVIDER_INVALID",
+    "PROVIDER_UNAVAILABLE",
+    "STALE_INTENT",
+    "STALE_BINDING",
+    "APPROVAL_INVALID",
+    "APPROVAL_EXPIRED",
+    "IDEMPOTENCY_CONFLICT",
+    "REQUEST_IN_PROGRESS",
+    "RETRY_INELIGIBLE",
+    "CONNECT_SESSION_EXPIRED",
+    "CONNECT_STEP_CONFLICT",
+    "CONNECT_STEP_UNKNOWN",
+    "STATE_RECOVERY_REQUIRED",
+    "DURABILITY_ERROR",
+]);
+/** Static text kept in place of every server-authored message. */
+const SERVER_ERROR_MESSAGE = "the server rejected the request";
+/** Placeholder for a server code the SDK does not recognize. */
+const UNKNOWN_SERVER_ERROR_CODE = "UNKNOWN_ERROR";
+/** A dotted path with optional array indices, e.g. `targets[0].options.visibility`. */
+const FIELD_PATH_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*|\[[0-9]{1,6}\])*$/;
+/**
+ * A Syndroo operation id. Core mints every id as `<prefix>_<base64url>` (for
+ * example `op_2f8c...`), so the shape - a short lowercase prefix, then a
+ * base64url token - is checkable without importing Core. A string that does not
+ * have it is not an id the SDK will echo back.
+ */
+const OPERATION_ID_PATTERN = /^[a-z][a-z0-9]{0,7}_[A-Za-z0-9_-]{1,118}$/;
+/** RFC 3339 date-time, the `IsoTime` shape the wire schema uses. */
+const ISO_TIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?(Z|[+-]\d{2}:\d{2})$/;
+function projectDetails(raw) {
+    if (raw === null || typeof raw !== "object") {
+        return undefined;
     }
-}
-/** The caller's argument cannot become a valid Syndroo request. */
-export class SyndrooValidationError extends SyndrooError {
-    constructor(message) {
-        super(message, { code: "VALIDATION" });
-        this.name = "SyndrooValidationError";
+    const source = raw;
+    const details = {};
+    const field = source["field"];
+    if (typeof field === "string" && field.length <= 256 && FIELD_PATH_PATTERN.test(field)) {
+        details.field = field;
     }
-}
-/** The caller aborted through an AbortSignal. */
-export class SyndrooAbortError extends SyndrooError {
-    constructor(message, init = {}) {
-        super(message, {
-            code: "ABORTED",
-            cause: init.cause,
-            requestMayHaveBeenApplied: init.requestMayHaveBeenApplied,
-        });
-        this.name = "SyndrooAbortError";
+    const operationId = source["operationId"];
+    if (typeof operationId === "string" && OPERATION_ID_PATTERN.test(operationId)) {
+        details.operationId = operationId;
     }
-}
-/** The configured deadline elapsed before the response was received. */
-export class SyndrooTimeoutError extends SyndrooError {
-    timeoutMs;
-    constructor(message, init) {
-        super(message, {
-            code: "TIMEOUT",
-            cause: init.cause,
-            requestMayHaveBeenApplied: init.requestMayHaveBeenApplied,
-        });
-        this.name = "SyndrooTimeoutError";
-        this.timeoutMs = init.timeoutMs;
+    const retryAt = source["retryAt"];
+    if (typeof retryAt === "string" && ISO_TIME_PATTERN.test(retryAt)) {
+        details.retryAt = retryAt;
     }
+    return Object.keys(details).length === 0 ? undefined : details;
 }
 /**
- * The request never produced an HTTP response. `networkCode` carries the
- * runtime's error code, such as `ECONNREFUSED`, when one is available.
+ * Project a server-authored error onto a fixed, allowlisted shape.
+ *
+ * Only three fields survive, each of them validated: an allowlisted `code` (an
+ * unrecognized code becomes `UNKNOWN_ERROR`), a static `message`, and `details`
+ * rebuilt from scratch so unknown keys, wrong types and malformed values are
+ * dropped. Nothing is copied by reference, so mutating the original object
+ * afterwards cannot change what an error reports.
  */
-export class SyndrooNetworkError extends SyndrooError {
-    networkCode;
-    constructor(message, init) {
-        super(message, {
-            code: "NETWORK",
-            cause: init.cause,
-            requestMayHaveBeenApplied: init.requestMayHaveBeenApplied,
-        });
-        this.name = "SyndrooNetworkError";
-        if (init.networkCode !== undefined) {
-            this.networkCode = init.networkCode;
-        }
+export function projectServerError(raw) {
+    if (raw === null || typeof raw !== "object") {
+        return undefined;
+    }
+    const source = raw;
+    const rawCode = source["code"];
+    const code = typeof rawCode === "string" && SERVER_ERROR_CODES.has(rawCode)
+        ? rawCode
+        : UNKNOWN_SERVER_ERROR_CODE;
+    const error = { code, message: SERVER_ERROR_MESSAGE };
+    const details = projectDetails(source["details"]);
+    if (details !== undefined) {
+        error.details = details;
     }
+    return error;
 }
+/** Fixed messages. Nothing here is interpolated from input or from a response. */
+const MESSAGES = Object.freeze({
+    INVALID_ARGUMENT: "the SDK call was given an argument outside its documented bounds",
+    INSECURE_BASE_URL: "the base URL is not an acceptable Syndroo endpoint",
+    INVALID_REQUEST: "the request does not match the Syndroo wire protocol",
+    INVALID_RESPONSE: "the server response does not match the Syndroo wire protocol",
+    RESPONSE_TOO_LARGE: "the server response exceeded the protocol size bound",
+    REDIRECT_NOT_ALLOWED: "the server answered with a redirect, which the SDK never follows",
+    TRANSPORT: "the request could not be completed at the transport layer",
+    HTTP_ERROR: "the server answered with an unexpected HTTP status",
+    PROTOCOL: "the server rejected the request",
+    TIMEOUT: "the request deadline elapsed before a response arrived",
+    ABORTED: "the call was cancelled locally",
+    WAIT_TIMEOUT: "the wait deadline elapsed before the execution round completed",
+    CONFIRMATION_REQUIRED: "the operation is waiting for explicit confirmation",
+    CONFIRMATION_EXPIRED: "the prepared operation's confirmation window has expired",
+});
 /**
- * Syndroo answered, but the answer is not the documented JSON contract: a
- * non-JSON body, a missing required field, or a body above the configured
- * size limit. The outcome of a write is never inferred from a bad response.
+ * One error type for transport, protocol and local-cancellation failures.
+ *
+ * `retryable` describes the SDK's own transport-retry decision for this failure
+ * and is never advice to retry content: an `unknown` business outcome is a
+ * successful protocol call, not an error, and is never auto-retried.
  */
-export class SyndrooResponseError extends SyndrooError {
+export class SyndrooError extends Error {
+    code;
     status;
-    preview;
-    constructor(message, init = {}) {
-        super(message, {
-            code: "INVALID_RESPONSE",
-            cause: init.cause,
-            requestMayHaveBeenApplied: init.requestMayHaveBeenApplied,
-        });
-        this.name = "SyndrooResponseError";
+    serverError;
+    retryable;
+    constructor(code, init = {}) {
+        super(MESSAGES[code]);
+        this.name = "SyndrooError";
+        this.code = code;
         if (init.status !== undefined) {
             this.status = init.status;
         }
-        if (init.preview !== undefined) {
-            this.preview = init.preview;
-        }
-    }
-}
-/**
- * Syndroo rejected the request with a documented error envelope. `code` is the
- * server's code such as `UNAUTHORIZED`, `POST_NOT_FOUND`,
- * `IDEMPOTENCY_CONFLICT`, or `PLATFORM_NOT_CONFIGURED`, and `HTTP_<status>`
- * when the body did not carry one.
- */
-export class SyndrooApiError extends SyndrooError {
-    status;
-    retryAfterMs;
-    constructor(message, init) {
-        super(message, {
-            code: init.code,
-            cause: init.cause,
-            requestMayHaveBeenApplied: init.requestMayHaveBeenApplied,
-        });
-        this.name = "SyndrooApiError";
-        this.status = init.status;
-        if (init.retryAfterMs !== undefined) {
-            this.retryAfterMs = init.retryAfterMs;
-        }
-    }
-    /** Syndroo or an intermediary asked the client to slow down. */
-    get retryable() {
-        return this.status === 429 || this.status >= 500;
-    }
-}
-/** `posts.wait` reached its deadline before the post became terminal. */
-export class SyndrooWaitTimeoutError extends SyndrooError {
-    postId;
-    timeoutMs;
-    lastStatus;
-    lastPost;
-    lastError;
-    constructor(message, init) {
-        super(message, { code: "WAIT_TIMEOUT", requestMayHaveBeenApplied: false });
-        this.name = "SyndrooWaitTimeoutError";
-        this.postId = init.postId;
-        this.timeoutMs = init.timeoutMs;
-        if (init.lastStatus !== undefined) {
-            this.lastStatus = init.lastStatus;
-        }
-        if (init.lastPost !== undefined) {
-            this.lastPost = init.lastPost;
-        }
-        if (init.lastError !== undefined) {
-            this.lastError = init.lastError;
+        if (init.serverError !== undefined) {
+            const projected = projectServerError(init.serverError);
+            if (projected !== undefined) {
+                this.serverError = projected;
+            }
         }
+        this.retryable = init.retryable ?? code === "TRANSPORT";
     }
 }
 export function isSyndrooError(value) {
     return value instanceof SyndrooError;
 }
-/**
- * Internal helper for bounded diagnostics. Error messages and response
- * previews must never grow with the size of an untrusted body.
- */
-export function truncate(value, limit) {
-    if (value.length <= limit) {
-        return value;
-    }
-    return `${value.slice(0, limit)}...[${value.length - limit} more characters]`;
-}
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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