@syndroo/sdk 0.4.0-rc.1

package/dist/http.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The single HTTP transport used by the SDK.
+ *
+ * Invariants this module enforces for every request:
+ *
+ * - exactly one network request per call; the SDK never retries a write,
+ *   because a retry without a stable idempotency key can duplicate a post;
+ * - redirects are not followed, so the `Authorization` header can never reach
+ *   a redirect target;
+ * - every request is bounded by a finite deadline;
+ * - the response body is read with a size limit, so an oversized or hostile
+ *   response cannot exhaust the caller's memory;
+ * - no logging, so credentials and content never reach stdout or stderr.
+ */
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const DEFAULT_MAX_RESPONSE_BYTES: number;
+export declare const MIN_MAX_RESPONSE_BYTES = 1024;
+export interface TransportConfig {
+    baseUrl: string;
+    apiKey: string;
+    timeoutMs: number;
+    maxResponseBytes: number;
+}
+export interface TransportRequest {
+    method: "GET" | "POST";
+    path: string;
+    query?: Record<string, string> | undefined;
+    json?: unknown;
+    idempotencyKey?: string | undefined;
+    /** `false` for unauthenticated endpoints such as `/health`. */
+    authenticated?: boolean | undefined;
+    signal?: AbortSignal | undefined;
+    timeoutMs?: number | undefined;
+}
+export interface TransportResponse {
+    status: number;
+    body: unknown;
+}
+export declare function sendRequest(config: TransportConfig, request: TransportRequest): Promise<TransportResponse>;
+/**
+ * Node keeps the process alive for a pending timer. An SDK call must not pin a
+ * CLI process open after its response or its deadline.
+ */
+export declare function unrefTimer(handle: unknown): void;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,0BAA0B,QAAkB,CAAC;AAC1D,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAI3C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAiH5B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAOhD"}

package/dist/http.js

@@ -0,0 +1,298 @@
+/**
+ * The single HTTP transport used by the SDK.
+ *
+ * Invariants this module enforces for every request:
+ *
+ * - exactly one network request per call; the SDK never retries a write,
+ *   because a retry without a stable idempotency key can duplicate a post;
+ * - redirects are not followed, so the `Authorization` header can never reach
+ *   a redirect target;
+ * - every request is bounded by a finite deadline;
+ * - the response body is read with a size limit, so an oversized or hostile
+ *   response cannot exhaust the caller's memory;
+ * - no logging, so credentials and content never reach stdout or stderr.
+ */
+import { SyndrooAbortError, SyndrooApiError, SyndrooError, SyndrooNetworkError, SyndrooResponseError, SyndrooTimeoutError, truncate, } from "./errors.js";
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const DEFAULT_MAX_RESPONSE_BYTES = 8 * 1024 * 1024;
+export const MIN_MAX_RESPONSE_BYTES = 1024;
+const PREVIEW_LIMIT = 200;
+const MAX_RETRY_AFTER_MS = 24 * 60 * 60 * 1000;
+export async function sendRequest(config, request) {
+    const url = buildUrl(config.baseUrl, request.path, request.query);
+    const timeoutMs = request.timeoutMs ?? config.timeoutMs;
+    const isWrite = request.method !== "GET";
+    const userSignal = request.signal;
+    if (userSignal?.aborted === true) {
+        throw new SyndrooAbortError("The request was aborted before it was sent, so nothing reached Syndroo.", { cause: userSignal.reason, requestMayHaveBeenApplied: false });
+    }
+    // Read through a call so TypeScript's narrowing from the check above does not
+    // make the later failure classification unreachable.
+    const callerAbort = () => ({
+        aborted: userSignal?.aborted === true,
+        reason: userSignal?.reason,
+    });
+    const headers = new Headers({ accept: "application/json" });
+    if (request.authenticated !== false) {
+        headers.set("authorization", `Bearer ${config.apiKey}`);
+    }
+    if (request.idempotencyKey !== undefined) {
+        headers.set("idempotency-key", request.idempotencyKey);
+    }
+    const init = {
+        method: request.method,
+        headers,
+        redirect: "manual",
+    };
+    if (request.json !== undefined) {
+        headers.set("content-type", "application/json");
+        init.body = JSON.stringify(request.json);
+    }
+    const controller = new AbortController();
+    let timedOut = false;
+    const handle = setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+    }, timeoutMs);
+    unrefTimer(handle);
+    init.signal = controller.signal;
+    const forwardAbort = () => {
+        controller.abort();
+    };
+    userSignal?.addEventListener("abort", forwardAbort, { once: true });
+    try {
+        const response = await globalThis.fetch(url, init);
+        if (isRedirectResponse(response)) {
+            throw new SyndrooApiError("Syndroo answered with a redirect. The SDK does not follow redirects " +
+                "because the Authorization header must never be forwarded to another " +
+                "location; point baseUrl at the final API origin instead.", {
+                code: "REDIRECT_NOT_FOLLOWED",
+                status: response.status,
+                requestMayHaveBeenApplied: false,
+            });
+        }
+        const text = await readBody(response, config.maxResponseBytes, isWrite);
+        const preview = truncate(text, PREVIEW_LIMIT);
+        if (!response.ok) {
+            throw apiError(response, text, preview, isWrite);
+        }
+        return {
+            status: response.status,
+            body: parseJson(text, response.status, preview, isWrite),
+        };
+    }
+    catch (error) {
+        if (error instanceof SyndrooError) {
+            throw error;
+        }
+        if (timedOut) {
+            throw new SyndrooTimeoutError(timeoutMessage(isWrite, timeoutMs), {
+                timeoutMs,
+                cause: error,
+                requestMayHaveBeenApplied: isWrite,
+            });
+        }
+        const caller = callerAbort();
+        if (caller.aborted) {
+            throw new SyndrooAbortError(abortMessage(isWrite), {
+                cause: caller.reason ?? error,
+                requestMayHaveBeenApplied: isWrite,
+            });
+        }
+        throw new SyndrooNetworkError(networkMessage(isWrite, error), {
+            cause: error,
+            networkCode: networkCodeOf(error),
+            requestMayHaveBeenApplied: isWrite,
+        });
+    }
+    finally {
+        clearTimeout(handle);
+        userSignal?.removeEventListener("abort", forwardAbort);
+    }
+}
+/**
+ * Node keeps the process alive for a pending timer. An SDK call must not pin a
+ * CLI process open after its response or its deadline.
+ */
+export function unrefTimer(handle) {
+    const candidate = handle;
+    const unref = candidate.unref;
+    if (typeof unref === "function") {
+        unref.call(handle);
+    }
+}
+function buildUrl(baseUrl, path, query) {
+    const url = new URL(`${baseUrl}${path}`);
+    for (const [key, value] of Object.entries(query ?? {})) {
+        url.searchParams.set(key, value);
+    }
+    return url;
+}
+function isRedirectResponse(response) {
+    if (response.type === "opaqueredirect") {
+        return true;
+    }
+    return response.status >= 300 && response.status < 400;
+}
+async function readBody(response, maxBytes, isWrite) {
+    const body = response.body;
+    if (body === null) {
+        return "";
+    }
+    const reader = body.getReader();
+    const chunks = [];
+    let length = 0;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done) {
+                break;
+            }
+            length += value.byteLength;
+            if (length > maxBytes) {
+                await reader.cancel("Response exceeded the SDK response size limit").catch(() => undefined);
+                throw new SyndrooResponseError(`Syndroo returned a response larger than the configured limit of ${maxBytes} bytes. ` +
+                    "Raise maxResponseBytes only for a trusted deployment.", {
+                    status: response.status,
+                    requestMayHaveBeenApplied: mayHaveBeenApplied(response.status, isWrite),
+                });
+            }
+            chunks.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return new TextDecoder().decode(bytes);
+}
+function parseJson(text, status, preview, isWrite) {
+    if (text === "") {
+        return undefined;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new SyndrooResponseError(`Syndroo returned HTTP ${status} with a body that is not JSON: ${preview}`, {
+            status,
+            preview,
+            requestMayHaveBeenApplied: mayHaveBeenApplied(status, isWrite),
+        });
+    }
+}
+function apiError(response, text, preview, isWrite) {
+    const envelope = errorEnvelope(text);
+    return new SyndrooApiError(envelope?.message ??
+        `Syndroo returned HTTP ${response.status} without a documented error body: ${preview}`, {
+        code: envelope?.code ?? `HTTP_${response.status}`,
+        status: response.status,
+        requestMayHaveBeenApplied: mayHaveBeenApplied(response.status, isWrite),
+        retryAfterMs: retryAfterMs(response.headers.get("retry-after")),
+    });
+}
+function errorEnvelope(text) {
+    if (text === "") {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+        return undefined;
+    }
+    const error = parsed.error;
+    if (typeof error !== "object" || error === null) {
+        return undefined;
+    }
+    const record = error;
+    const code = typeof record.code === "string" ? record.code : undefined;
+    const message = typeof record.message === "string" ? record.message : undefined;
+    if (code === undefined || message === undefined) {
+        return undefined;
+    }
+    return { code, message: truncate(message, PREVIEW_LIMIT) };
+}
+/**
+ * `Retry-After` is either a number of seconds or an HTTP date. Both are
+ * converted to a bounded delay so a caller can honor backpressure without
+ * trusting an attacker-controlled header to park the process for days.
+ */
+function retryAfterMs(header) {
+    if (header === null) {
+        return undefined;
+    }
+    const trimmed = header.trim();
+    const seconds = Number(trimmed);
+    if (trimmed !== "" && Number.isFinite(seconds) && seconds >= 0) {
+        return Math.min(seconds * 1000, MAX_RETRY_AFTER_MS);
+    }
+    const date = Date.parse(trimmed);
+    if (Number.isNaN(date)) {
+        return undefined;
+    }
+    return Math.min(Math.max(date - Date.now(), 0), MAX_RETRY_AFTER_MS);
+}
+/**
+ * A write may have been applied when Syndroo accepted it (2xx) or when the
+ * failure happened at or after the server's processing boundary (5xx). A 4xx
+ * is a decision, so nothing was applied.
+ */
+function mayHaveBeenApplied(status, isWrite) {
+    if (!isWrite) {
+        return false;
+    }
+    return status >= 500 || (status >= 200 && status < 300);
+}
+function timeoutMessage(isWrite, timeoutMs) {
+    if (!isWrite) {
+        return (`Request timed out after ${timeoutMs}ms. This was a read, so nothing was ` +
+            "created; retrying is safe.");
+    }
+    return (`Request timed out after ${timeoutMs}ms. Syndroo may still have accepted the ` +
+        "post: do not resend it with a new Idempotency-Key. Look the post up with " +
+        "posts.list, or retry the identical request with the same key.");
+}
+function abortMessage(isWrite) {
+    if (!isWrite) {
+        return "The request was aborted after it was sent. This was a read, so nothing was created.";
+    }
+    return ("The request was aborted after it was sent, so Syndroo may still have " +
+        "accepted the post: do not resend it with a new Idempotency-Key. Look the " +
+        "post up with posts.list, or retry the identical request with the same key.");
+}
+function networkMessage(isWrite, error) {
+    const code = networkCodeOf(error);
+    const suffix = code === undefined ? "" : ` (${code})`;
+    if (!isWrite) {
+        return `The request failed before a response was received${suffix}.`;
+    }
+    return (`The request failed before a response was received${suffix}. Syndroo may ` +
+        "still have accepted the post: do not resend it with a new " +
+        "Idempotency-Key. Look the post up with posts.list, or retry the identical " +
+        "request with the same key.");
+}
+function networkCodeOf(error) {
+    let current = error;
+    for (let depth = 0; depth < 4; depth += 1) {
+        if (typeof current !== "object" || current === null) {
+            return undefined;
+        }
+        const code = current.code;
+        if (typeof code === "string" && code !== "") {
+            return truncate(code, 40);
+        }
+        current = current.cause;
+    }
+    return undefined;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public entry point of `@syndroo/sdk`.
+ *
+ * The SDK is a thin HTTP client for a deployed Syndroo instance. It keeps the
+ * documented `/v1` contract and adds no server-side behavior.
+ */
+export { DEFAULT_MAX_POLL_INTERVAL_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_WAIT_TIMEOUT_MS, PostsResource, SyndrooClient, type CreatePostOptions, type ListPostsOptions, type RequestOptions, type SyndrooClientOptions, type WaitOptions, } from "./client.js";
+export { SyndrooAbortError, SyndrooApiError, SyndrooConfigError, SyndrooError, SyndrooNetworkError, SyndrooResponseError, SyndrooTimeoutError, SyndrooValidationError, SyndrooWaitTimeoutError, isSyndrooError, type SyndrooErrorCode, type SyndrooErrorInit, } from "./errors.js";
+export { isPostDelivered, isPostTerminal, type CreatePostInput, type HealthStatus, type KnownPlatform, type Platform, type PostDetail, type PostOverride, type PostReceipt, type PostStatus, type PostSummary, type Publication, type PublicationStatus, type PublishErrorCode, type SupportsFutureValues, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Public entry point of `@syndroo/sdk`.
+ *
+ * The SDK is a thin HTTP client for a deployed Syndroo instance. It keeps the
+ * documented `/v1` contract and adds no server-side behavior.
+ */
+export { DEFAULT_MAX_POLL_INTERVAL_MS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_WAIT_TIMEOUT_MS, PostsResource, SyndrooClient, } from "./client.js";
+export { SyndrooAbortError, SyndrooApiError, SyndrooConfigError, SyndrooError, SyndrooNetworkError, SyndrooResponseError, SyndrooTimeoutError, SyndrooValidationError, SyndrooWaitTimeoutError, isSyndrooError, } from "./errors.js";
+export { isPostDelivered, isPostTerminal, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,aAAa,GAMd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,GAGf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,cAAc,GAcf,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Wire types and narrow runtime readers for the documented Syndroo HTTP
+ * contract (see the "HTTP API" section of the repository README).
+ *
+ * These declarations are intentionally independent of the private
+ * `@syndroo/core` workspace package: the published SDK must keep zero runtime
+ * dependencies, and the server contract — not the internal domain model — is
+ * what users depend on.
+ */
+/** Platforms the docs describe today. The SDK accepts any string the server accepts. */
+export type KnownPlatform = "x" | "threads" | "bluesky" | "tumblr" | "mastodon" | "linkedin" | "nostr";
+/**
+ * Literal-union helper: editors still complete the documented names, while a
+ * value the server adds later does not become a type error for consumers.
+ */
+export type SupportsFutureValues<T extends string> = T | (string & {});
+export type Platform = SupportsFutureValues<KnownPlatform>;
+export type PostStatus = "scheduled" | "queued" | "publishing" | "published" | "partial" | "failed";
+export type PublicationStatus = "scheduled" | "pending" | "publishing" | "published" | "failed";
+export type PublishErrorCode = "AUTH" | "RATE_LIMIT" | "INVALID_CONTENT" | "PROVIDER_UNAVAILABLE" | "NETWORK" | "UNKNOWN";
+export interface PostOverride {
+    content?: string;
+}
+/** The request body of `POST /v1/posts`, passed through unchanged. */
+export interface CreatePostInput {
+    content: string;
+    platforms: Platform[];
+    overrides?: Record<string, PostOverride>;
+    scheduledAt?: string;
+}
+/**
+ * The acceptance receipt for `POST /v1/posts`. HTTP `202` means the request was
+ * accepted for processing; it is not a delivery result. Read the post (and each
+ * publication) before claiming that anything reached a platform.
+ */
+export interface PostReceipt {
+    id: string;
+    status: SupportsFutureValues<PostStatus>;
+    scheduledAt?: string;
+    enqueueDeferred?: boolean;
+    replayed?: boolean;
+}
+export interface PostSummary {
+    id: string;
+    content: string;
+    platforms: Platform[];
+    status: SupportsFutureValues<PostStatus>;
+    createdAt: string;
+    scheduledAt?: string;
+    overrides?: Record<string, PostOverride>;
+}
+export interface Publication {
+    id: string;
+    postId: string;
+    platform: Platform;
+    provider: string;
+    content: string;
+    status: SupportsFutureValues<PublicationStatus>;
+    attempts: number;
+    errorAmbiguous?: boolean;
+    externalId?: string;
+    externalUrl?: string;
+    errorCode?: SupportsFutureValues<PublishErrorCode>;
+    errorMessage?: string;
+    createdAt?: string;
+    scheduledAt?: string;
+    enqueuedAt?: string;
+    publishingAt?: string;
+    publishedAt?: string;
+}
+export interface PostDetail extends PostSummary {
+    publications: Publication[];
+}
+export interface HealthStatus {
+    status: string;
+}
+/** Context attached to a parse failure so callers know what Syndroo answered. */
+export interface ParseContext {
+    status?: number | undefined;
+    requestMayHaveBeenApplied?: boolean | undefined;
+}
+/** `published`, `partial`, and `failed` stop changing without a new request. */
+export declare function isPostTerminal(status: string): boolean;
+/** Every selected platform succeeded. Anything else is not a delivery. */
+export declare function isPostDelivered(status: string): boolean;
+export declare function parsePostReceipt(value: unknown, context?: ParseContext): PostReceipt;
+export declare function parsePostSummary(value: unknown, context?: ParseContext, label?: string): PostSummary;
+export declare function parsePostDetail(value: unknown, context?: ParseContext): PostDetail;
+export declare function parsePostList(value: unknown, context?: ParseContext): PostSummary[];
+export declare function parseHealth(value: unknown, context?: ParseContext): HealthStatus;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,159 @@
+/**
+ * Wire types and narrow runtime readers for the documented Syndroo HTTP
+ * contract (see the "HTTP API" section of the repository README).
+ *
+ * These declarations are intentionally independent of the private
+ * `@syndroo/core` workspace package: the published SDK must keep zero runtime
+ * dependencies, and the server contract — not the internal domain model — is
+ * what users depend on.
+ */
+import { SyndrooResponseError, truncate } from "./errors.js";
+const TERMINAL_POST_STATUSES = new Set([
+    "published",
+    "partial",
+    "failed",
+]);
+/** `published`, `partial`, and `failed` stop changing without a new request. */
+export function isPostTerminal(status) {
+    return TERMINAL_POST_STATUSES.has(status);
+}
+/** Every selected platform succeeded. Anything else is not a delivery. */
+export function isPostDelivered(status) {
+    return status === "published";
+}
+export function parsePostReceipt(value, context = {}) {
+    const record = requireRecord(value, "the create response");
+    const receipt = {
+        id: requireString(record["id"], "create response id", context),
+        status: requireString(record["status"], "create response status", context),
+    };
+    assignOptional(receipt, "scheduledAt", optionalString(record["scheduledAt"], "create response scheduledAt", context));
+    assignOptional(receipt, "enqueueDeferred", optionalBoolean(record["enqueueDeferred"], "create response enqueueDeferred", context));
+    assignOptional(receipt, "replayed", optionalBoolean(record["replayed"], "create response replayed", context));
+    return receipt;
+}
+export function parsePostSummary(value, context = {}, label = "post") {
+    const record = requireRecord(value, label, context);
+    const summary = {
+        id: requireString(record["id"], `${label} id`, context),
+        content: requireString(record["content"], `${label} content`, context),
+        platforms: requireArray(record["platforms"], `${label} platforms`, context).map((platform, index) => requireString(platform, `${label} platforms[${index}]`, context)),
+        status: requireString(record["status"], `${label} status`, context),
+        createdAt: requireString(record["createdAt"], `${label} createdAt`, context),
+    };
+    assignOptional(summary, "scheduledAt", optionalString(record["scheduledAt"], `${label} scheduledAt`, context));
+    assignOptional(summary, "overrides", optionalOverrides(record["overrides"], `${label} overrides`, context));
+    return summary;
+}
+export function parsePostDetail(value, context = {}) {
+    const record = requireRecord(value, "post", context);
+    const publications = requireArray(record["publications"], "post publications", context).map((item, index) => parsePublication(item, `post publications[${index}]`, context));
+    return { ...parsePostSummary(record, context), publications };
+}
+export function parsePostList(value, context = {}) {
+    const record = requireRecord(value, "the list response", context);
+    return requireArray(record["items"], "list response items", context).map((item, index) => parsePostSummary(item, context, `list response items[${index}]`));
+}
+export function parseHealth(value, context = {}) {
+    const record = requireRecord(value, "the health response", context);
+    return { status: requireString(record["status"], "health response status", context) };
+}
+function parsePublication(value, label, context) {
+    const record = requireRecord(value, label, context);
+    const publication = {
+        id: requireString(record["id"], `${label} id`, context),
+        postId: requireString(record["postId"], `${label} postId`, context),
+        platform: requireString(record["platform"], `${label} platform`, context),
+        provider: requireString(record["provider"], `${label} provider`, context),
+        content: requireString(record["content"], `${label} content`, context),
+        status: requireString(record["status"], `${label} status`, context),
+        attempts: requireNumber(record["attempts"], `${label} attempts`, context),
+    };
+    assignOptional(publication, "errorAmbiguous", optionalBoolean(record["errorAmbiguous"], `${label} errorAmbiguous`, context));
+    assignOptional(publication, "externalId", optionalString(record["externalId"], `${label} externalId`, context));
+    assignOptional(publication, "externalUrl", optionalString(record["externalUrl"], `${label} externalUrl`, context));
+    assignOptional(publication, "errorCode", optionalString(record["errorCode"], `${label} errorCode`, context));
+    assignOptional(publication, "errorMessage", optionalString(record["errorMessage"], `${label} errorMessage`, context));
+    assignOptional(publication, "createdAt", optionalString(record["createdAt"], `${label} createdAt`, context));
+    assignOptional(publication, "scheduledAt", optionalString(record["scheduledAt"], `${label} scheduledAt`, context));
+    assignOptional(publication, "enqueuedAt", optionalString(record["enqueuedAt"], `${label} enqueuedAt`, context));
+    assignOptional(publication, "publishingAt", optionalString(record["publishingAt"], `${label} publishingAt`, context));
+    assignOptional(publication, "publishedAt", optionalString(record["publishedAt"], `${label} publishedAt`, context));
+    return publication;
+}
+function optionalOverrides(value, label, context) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const record = requireRecord(value, label, context);
+    const overrides = {};
+    for (const [platform, override] of Object.entries(record)) {
+        const entry = requireRecord(override, `${label}.${platform}`, context);
+        const content = optionalString(entry["content"], `${label}.${platform}.content`, context);
+        overrides[platform] = content === undefined ? {} : { content };
+    }
+    return overrides;
+}
+function assignOptional(target, key, value) {
+    if (value !== undefined) {
+        target[key] = value;
+    }
+}
+function requireRecord(value, label, context = {}) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw invalid(`${label} must be a JSON object, received ${describe(value)}`, context);
+    }
+    return value;
+}
+function requireArray(value, label, context = {}) {
+    if (!Array.isArray(value)) {
+        throw invalid(`${label} must be an array, received ${describe(value)}`, context);
+    }
+    return value;
+}
+function requireString(value, label, context = {}) {
+    if (typeof value !== "string") {
+        throw invalid(`${label} must be a string, received ${describe(value)}`, context);
+    }
+    return value;
+}
+function requireNumber(value, label, context = {}) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw invalid(`${label} must be a number, received ${describe(value)}`, context);
+    }
+    return value;
+}
+function optionalString(value, label, context = {}) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    return requireString(value, label, context);
+}
+function optionalBoolean(value, label, context = {}) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "boolean") {
+        throw invalid(`${label} must be a boolean, received ${describe(value)}`, context);
+    }
+    return value;
+}
+function invalid(message, context) {
+    return new SyndrooResponseError(`Syndroo returned a response that does not match the documented contract: ${message}.`, {
+        status: context.status,
+        requestMayHaveBeenApplied: context.requestMayHaveBeenApplied,
+    });
+}
+function describe(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (Array.isArray(value)) {
+        return `an array of ${value.length} item(s)`;
+    }
+    if (typeof value === "object") {
+        return `an object with keys ${truncate(Object.keys(value).join(", "), 80)}`;
+    }
+    return `${typeof value} (${truncate(String(value), 80)})`;
+}
+//# sourceMappingURL=types.js.map