@distilled.cloud/stripe 1.0.0-rc.16 → 1.0.0-rc.17

package/lib/protocol.js

@@ -1,471 +1 @@
-import * as API from "@distilled.cloud/core/api";
-import { debugHttp } from "@distilled.cloud/core/debug";
-import { ConfigError, HTTP_STATUS_MAP, InternalServerError, BadRequest, Conflict, Forbidden, Locked, NotFound, UnprocessableEntity, } from "@distilled.cloud/core/errors";
-import { buildRequest, getAnn, getProps, hasPropAnn, makeRequest, mapKeys, mapsVerbatim, matchTypedError, nameOf, } from "@distilled.cloud/core/protocol-http";
-import { hasSensitive, hasSensitiveMember, unwrapRedactedDeep, wrapSensitive, } from "@distilled.cloud/core/protocol-rest";
-import { checkResponse, withholdActual } from "@distilled.cloud/core/response-validation";
-import { parseRetryAfterForStatus } from "@distilled.cloud/core/retry-after";
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-import * as Context from "effect/Context";
-import * as Effect from "effect/Effect";
-import * as HttpBody from "effect/http/HttpBody";
-import * as HttpClient from "effect/http/HttpClient";
-import * as HttpClientRequest from "effect/http/HttpClientRequest";
-import * as Layer from "effect/Layer";
-import * as Redacted from "effect/Redacted";
-import { Credentials } from "./credentials.js";
-import { ApiError, CardError, ExternalDependencyFailed, IdempotencyError, InvalidRequestError, PaymentError, STRIPE_HTTP_STATUS_MAP, StripeParseError, UnknownStripeError, } from "./errors.js";
-import { bodySymbol, headerSymbol, httpSymbol, labelSymbol, querySymbol, } from "./traits.js";
-
-
-
-
-
-export class RequestOptions extends /*@__PURE__*/ /*@__PURE__*/ Context.Service()("StripeRequestOptions") {
-}
-
-
-
-
-
-
-
-
-
-
-export const withRequestOptions = (options) => Effect.provide(Layer.succeed(RequestOptions, options));
-const stripeRequestHeaders = (options) => {
-    const headers = {};
-    if (options?.idempotencyKey !== undefined) {
-        headers["Idempotency-Key"] = options.idempotencyKey;
-    }
-    if (options?.stripeAccount !== undefined) {
-        headers["Stripe-Account"] = options.stripeAccount;
-    }
-    if (options?.stripeContext !== undefined) {
-        headers["Stripe-Context"] = options.stripeContext;
-    }
-    if (options?.apiVersion !== undefined) {
-        headers["Stripe-Version"] = options.apiVersion;
-    }
-    return headers;
-};
-// Bridge: Protocol.decode is typed as Effect<unknown> (no error channel), but
-// Stripe failures are real typed errors that an operation re-surfaces via its
-// `errors: [...]` list / StripeOpError annotation. Fail with the instance and
-// erase the error type here; the generated annotations reintroduce it.
-const fail = (e) => Effect.fail(e);
-// =============================================================================
-// Stripe query / form encoding (ported from distilled v0)
-// =============================================================================
-const BODYLESS = /*@__PURE__*/ new Set(["GET", "HEAD"]);
-const appendQueryValue = (query, key, value) => {
-    if (value === undefined || value === null)
-        return;
-    query.append(key, typeof value === "boolean" ? (value ? "true" : "false") : String(value));
-};
-
-
-
-
-const appendStripeQuery = (query, key, value) => {
-    if (value === undefined || value === null)
-        return;
-    if (Array.isArray(value)) {
-        for (const item of value)
-            appendQueryValue(query, `${key}[]`, item);
-        return;
-    }
-    if (typeof value === "object" && !(value instanceof Date)) {
-        for (const [nestedKey, nestedValue] of Object.entries(value)) {
-            appendStripeQuery(query, `${key}[${nestedKey}]`, nestedValue);
-        }
-        return;
-    }
-    appendQueryValue(query, key, value);
-};
-
-
-
-
-
-
-
-
-
-
-const flattenToFormPairs = (obj, prefix = "") => {
-    const pairs = [];
-    for (const [key, value] of Object.entries(obj)) {
-        if (value === undefined || value === null)
-            continue;
-        const fullKey = prefix ? `${prefix}[${key}]` : key;
-        if (Array.isArray(value)) {
-            for (let i = 0; i < value.length; i++) {
-                const item = value[i];
-                if (item !== null &&
-                    item !== undefined &&
-                    typeof item === "object" &&
-                    !Array.isArray(item)) {
-                    pairs.push(...flattenToFormPairs(item, `${fullKey}[${i}]`));
-                }
-                else if (item !== undefined && item !== null) {
-                    pairs.push([`${fullKey}[${i}]`, String(item)]);
-                }
-            }
-        }
-        else if (typeof value === "object") {
-            pairs.push(...flattenToFormPairs(value, fullKey));
-        }
-        else if (typeof value === "boolean") {
-            pairs.push([fullKey, value ? "true" : "false"]);
-        }
-        else {
-            pairs.push([fullKey, String(value)]);
-        }
-    }
-    return pairs;
-};
-
-const buildFormUrlEncoded = (body) => {
-    const params = new URLSearchParams();
-    for (const [key, value] of flattenToFormPairs(body)) {
-        params.append(key, value);
-    }
-    return params.toString();
-};
-const requestPlans = /*@__PURE__*/ new WeakMap();
-const requestPlanFor = (inputAst) => {
-    let plan = requestPlans.get(inputAst);
-    if (plan !== undefined)
-        return plan;
-    const http = getAnn(inputAst, httpSymbol);
-    if (!http) {
-        throw new Error("operation input is missing the Http() trait");
-    }
-    const members = getProps(inputAst).map((prop) => {
-        const key = String(prop.name);
-        if (hasPropAnn(prop, labelSymbol)) {
-            return {
-                key,
-                bind: "label",
-                name: nameOf(prop, labelSymbol),
-                type: prop.type,
-                verbatim: true,
-            };
-        }
-        if (hasPropAnn(prop, headerSymbol)) {
-            const name = nameOf(prop, headerSymbol).toLowerCase();
-            return { key, bind: "header", name, type: prop.type, verbatim: true };
-        }
-        if (hasPropAnn(prop, querySymbol)) {
-            return {
-                key,
-                bind: "query",
-                name: nameOf(prop, querySymbol),
-                type: prop.type,
-                verbatim: true,
-            };
-        }
-        return {
-            key,
-            bind: "body",
-            name: nameOf(prop, bodySymbol),
-            type: prop.type,
-            verbatim: mapsVerbatim(prop.type, "encode"),
-        };
-    });
-    plan = { http, members, known: new Set(members.map((m) => m.key)) };
-    requestPlans.set(inputAst, plan);
-    return plan;
-};
-const requestFor = (creds, options, input, inputAst) => {
-    const { http, members, known } = requestPlanFor(inputAst);
-    const baseHeaders = {
-        Authorization: `Bearer ${Redacted.value(creds.apiKey)}`,
-        ...stripeRequestHeaders(options),
-        Accept: "application/json",
-    };
-    // Multipart (POST /v1/files): core's buildRequest speaks multipart
-    // form-data (file parts + JSON-encoded object parts) -- same behavior as
-    // v0's buildFormData.
-    if (http.contentType === "multipart") {
-        return buildRequest({
-            input: unwrapRedactedDeep(input),
-            inputAst,
-            baseUrl: creds.apiBaseUrl,
-            headers: baseHeaders,
-        });
-    }
-    const inputObj = (unwrapRedactedDeep(input) ?? {});
-    const headers = baseHeaders;
-    const body = {};
-    let bodyKeys = 0;
-    let query;
-    let uri = http.uri;
-    for (let i = 0; i < members.length; i++) {
-        const m = members[i];
-        const value = inputObj[m.key];
-        if (value === undefined)
-            continue;
-        switch (m.bind) {
-            case "label":
-                uri = uri.replace(`{${m.name}}`, encodeURIComponent(String(value)));
-                break;
-            case "header":
-                headers[m.name] = String(value);
-                break;
-            case "query":
-                // Stripe bracket expansion, not dotted params (`created[gte]=1`).
-                appendStripeQuery((query ??= new URLSearchParams()), m.name, value);
-                break;
-            default:
-                body[m.name] = m.verbatim ? value : mapKeys(m.type, value, "encode");
-                bodyKeys++;
-        }
-    }
-    // Input keys the schema doesn't know pass through as body fields -- the
-    // generated schemas can lag the real API, and silently dropping them
-    // would break working callers.
-    for (const key in inputObj) {
-        if (known.has(key) || !Object.hasOwn(inputObj, key))
-            continue;
-        const value = inputObj[key];
-        if (value === undefined)
-            continue;
-        body[key] = value;
-        bodyKeys++;
-    }
-    // v0's normalizeStripeGetQuery: GET inputs carry no body -- flatten the
-    // body-bound members into the query string with bracket notation.
-    const bodyless = BODYLESS.has(http.method);
-    if (bodyless && bodyKeys > 0) {
-        for (const [key, value] of Object.entries(body)) {
-            appendStripeQuery((query ??= new URLSearchParams()), key, value);
-        }
-    }
-    const qs = query === undefined ? "" : query.toString();
-    const url = qs ? `${creds.apiBaseUrl}${uri}?${qs}` : `${creds.apiBaseUrl}${uri}`;
-    if (debugHttp()) {
-        console.error(`[distilled] ${http.method} ${url}` +
-            (bodyKeys && !bodyless ? ` body=${JSON.stringify(body).slice(0, 400)}` : ""));
-    }
-    const request = makeRequest(http.method, url, headers);
-    if (bodyless || bodyKeys === 0)
-        return request;
-    return HttpClientRequest.setBody(request, http.contentType === "form-urlencoded"
-        ? HttpBody.text(buildFormUrlEncoded(body), "application/x-www-form-urlencoded")
-        : // The /v2/* operations are plain JSON.
-            HttpBody.jsonUnsafe(body));
-};
-
-
-
-
-
-
-
-const withCredentials = (context, f) => API.withValue(Context.get(context, Credentials), f);
-const encode = ({ input, inputAst }) => Effect.withFiber((fiber) => {
-    const context = fiber.context;
-    return withCredentials(context, (creds) => Effect.succeed(requestFor(creds, Context.getOrUndefined(context, RequestOptions), input, inputAst)));
-});
-// =============================================================================
-// Response decoding / error matching (ported from v0's matchError)
-// =============================================================================
-const str = (v) => (typeof v === "string" ? v : undefined);
-// Structural views of the status maps for numeric lookup (the const objects'
-// per-status class types don't unify without widening the constructor).
-const stripeStatusMap = STRIPE_HTTP_STATUS_MAP;
-const coreStatusMap = HTTP_STATUS_MAP;
-
-const stripeErrorEnvelope = (errorBody) => {
-    const envelope = errorBody !== null && typeof errorBody === "object"
-        ? errorBody.error
-        : undefined;
-    return envelope !== null && typeof envelope === "object"
-        ? envelope
-        : undefined;
-};
-const stripeErrorMessage = (errorBody) => {
-    const message = stripeErrorEnvelope(errorBody)?.message;
-    return typeof message === "string" ? message : undefined;
-};
-
-
-
-
-
-
-
-
-
-const matchStripeError = (status, errorBody, headers) => {
-    const err = stripeErrorEnvelope(errorBody);
-    // v0 parity: an unparseable envelope (no `error.type` string) is an
-    // UnknownStripeError carrying the raw body.
-    if (!err || typeof err.type !== "string") {
-        return new UnknownStripeError({ body: errorBody });
-    }
-    const common = {
-        message: str(err.message),
-        code: str(err.code),
-        doc_url: str(err.doc_url),
-        request_log_url: str(err.request_log_url),
-    };
-    // Match by Stripe error type first for richer error info.
-    switch (err.type) {
-        case "card_error":
-            return new CardError({
-                ...common,
-                decline_code: str(err.decline_code),
-                charge: str(err.charge),
-                param: str(err.param),
-                advice_code: str(err.advice_code),
-                network_advice_code: str(err.network_advice_code),
-                network_decline_code: str(err.network_decline_code),
-                payment_method_type: str(err.payment_method_type),
-            });
-        case "idempotency_error":
-            return new IdempotencyError(common);
-        case "invalid_request_error":
-            return new InvalidRequestError({ ...common, param: str(err.param) });
-        case "api_error":
-            return new ApiError({ ...common, param: str(err.param) });
-    }
-    // Fall back to Stripe-specific HTTP status codes (402, 424).
-    const StripeErrorClass = stripeStatusMap[status];
-    if (StripeErrorClass) {
-        return new StripeErrorClass({
-            message: common.message,
-            code: common.code,
-            ...(str(err.decline_code) !== undefined ? { decline_code: str(err.decline_code) } : {}),
-            ...(str(err.charge) !== undefined ? { charge: str(err.charge) } : {}),
-            ...(str(err.param) !== undefined ? { param: str(err.param) } : {}),
-            ...(common.doc_url !== undefined ? { doc_url: common.doc_url } : {}),
-            ...(common.request_log_url !== undefined ? { request_log_url: common.request_log_url } : {}),
-        });
-    }
-    // Fall back to standard HTTP status errors (400, 401, 403, 404, ...).
-    const CoreErrorClass = coreStatusMap[status];
-    if (CoreErrorClass) {
-        return new CoreErrorClass({
-            message: common.message ?? "",
-            retryAfter: parseRetryAfterForStatus(status, headers),
-        });
-    }
-    // Unmapped 5xx (e.g. proxy statuses) -> retryable server error (v1
-    // convention; v0 fell through to UnknownStripeError here).
-    if (status >= 500) {
-        return new InternalServerError({
-            message: common.message ?? `HTTP ${status}`,
-            retryAfter: parseRetryAfterForStatus(status, headers),
-        });
-    }
-    return new UnknownStripeError({
-        type: str(err.type),
-        code: common.code,
-        message: common.message,
-        param: str(err.param),
-        body: errorBody,
-    });
-};
-const decodeResponse = (context, response, outputAst, errorClasses) => Effect.matchEffect(response.text, {
-    onFailure: Effect.die,
-    onSuccess: (read) => {
-        // Read as text and parse tolerantly -- error pages can be non-JSON.
-        const text = read ?? "";
-        if (debugHttp()) {
-            console.error(`[distilled] <- ${response.status} ${text.slice(0, 400)}`);
-        }
-        let json;
-        let nonJson = false;
-        if (text.trim().length > 0) {
-            try {
-                json = JSON.parse(text);
-            }
-            catch {
-                nonJson = true;
-            }
-        }
-        const status = response.status;
-        const headers = response.headers;
-        if (status >= 400) {
-            const errorBody = nonJson ? text : json;
-            const message = stripeErrorMessage(errorBody) ??
-                (nonJson && text.trim() ? text.trim() : `HTTP ${status}`);
-            const typed = matchTypedError(errorClasses, status, [{ message }], {
-                body: nonJson ? text : json,
-                headers,
-            });
-            if (typed !== undefined)
-                return fail(typed);
-            return fail(matchStripeError(status, errorBody, headers));
-        }
-        // 2xx: the response body IS the payload (no envelope). Wire->TS key
-        // mapping is schema-driven; sensitive members come back Redacted.
-        // Strict mode checks the mapped body against the output schema first.
-        // For an output with sensitive members, a non-JSON body fails in every
-        // mode and parse errors withhold the body.
-        const withholdBody = hasSensitiveMember(outputAst);
-        if (nonJson && withholdBody) {
-            return fail(new StripeParseError({ body: "[REDACTED]", cause: "Invalid JSON response" }));
-        }
-        const body = nonJson ? text : (json ?? {});
-        const mapped = mapsVerbatim(outputAst, "decode") ? body : mapKeys(outputAst, body, "decode");
-        const cause = checkResponse(context, outputAst, mapped);
-        if (cause !== undefined) {
-            return fail(new StripeParseError({
-                body: withholdBody ? "[REDACTED]" : nonJson ? text : json,
-                cause: withholdBody ? withholdActual(cause) : cause,
-            }));
-        }
-        return Effect.succeed(hasSensitive(outputAst) ? wrapSensitive(outputAst, mapped) : mapped);
-    },
-});
-const call = (op, input) => Effect.withFiber((fiber) => {
-    const context = fiber.context;
-    return withCredentials(context, (creds) => {
-        const request = requestFor(creds, Context.getOrUndefined(context, RequestOptions), input, op.inputAst);
-        const client = Context.get(context, HttpClient.HttpClient);
-        return Effect.flatMap(client.execute(request), (response) => decodeResponse(context, response, op.outputAst, op.errors));
-    });
-});
-export const StripeProtocol = /*@__PURE__*/ Layer.succeed(API.Protocol, 
-/*@__PURE__*/ API.Protocol.of({
-    // Erase encode's Credentials requirement (see comment above).
-    encode: (args) => encode(args),
-    decode: ({ response, outputAst, errors }) => Effect.withFiber((fiber) => decodeResponse(fiber.context, response, outputAst, errors)),
-    call,
-}));
-//# sourceMappingURL=protocol.js.map
+export { protocol$RequestOptions as RequestOptions, protocol$StripeProtocol as StripeProtocol, protocol$withRequestOptions as withRequestOptions } from "./_bundle/sdk.js";

package/lib/retry.js

@@ -1,33 +1 @@
-import { throttlingFactory, transientFactory } from "@distilled.cloud/core/retry";
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-import * as Context from "effect/Context";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-export { makeDefault, jittered, capped, throttlingOptions, transientOptions, throttlingFactory, transientFactory, } from "@distilled.cloud/core/retry";
-
-export class Retry extends /*@__PURE__*/ /*@__PURE__*/ Context.Service()("StripeRetry") {
-}
-
-export const policy = (optionsOrFactory) => Effect.provide(Layer.succeed(Retry, optionsOrFactory));
-
-export const none = /*@__PURE__*/ Effect.provide(
-/*@__PURE__*/ Layer.succeed(Retry, { while: () => false }));
-
-export const throttling = /*@__PURE__*/ policy(throttlingFactory);
-
-export const transient = /*@__PURE__*/ policy(transientFactory);
-//# sourceMappingURL=retry.js.map
+export { retry$Retry as Retry, retry$capped as capped, retry$jittered as jittered, retry$makeDefault as makeDefault, retry$none as none, retry$policy as policy, retry$throttling as throttling, retry$throttlingFactory as throttlingFactory, retry$throttlingOptions as throttlingOptions, retry$transient as transient, retry$transientFactory as transientFactory, retry$transientOptions as transientOptions } from "./_bundle/sdk.js";

package/lib/services/index.js

@@ -1,3 +1 @@
-// AUTO-GENERATED by scripts/generate.ts. Do not edit.
 export * as stripe from "./stripe.js";
-//# sourceMappingURL=index.js.map