@hypequery/cloud-client 0.0.0-canary-20261113132821 → 0.0.0-stage

package/dist/index.d.ts

@@ -1,10 +0,0 @@
-export { createCloudClient, DEFAULT_CLOUD_URL } from './client.js';
-export type { CloudClient, CloudClientOptions, OperationInputArgs } from './client.js';
-export { CloudApiError, isCloudApiError } from './errors.js';
-export type { ClientErrorCode, CloudApiErrorInit, CloudErrorBody, CloudInputIssue } from './errors.js';
-export { parseErrorEnvelope } from './utils/error-envelope.js';
-export { buildRequest } from './utils/request.js';
-export type { BuiltRequest, RequestContext } from './utils/request.js';
-export type { CallOptions, CloudErrorSpec, HttpMethod, OperationMeta } from './types.js';
-export * from './generated/operations.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACvG,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzF,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,5 +0,0 @@
-export { createCloudClient, DEFAULT_CLOUD_URL } from './client.js';
-export { CloudApiError, isCloudApiError } from './errors.js';
-export { parseErrorEnvelope } from './utils/error-envelope.js';
-export { buildRequest } from './utils/request.js';
-export * from './generated/operations.js';

package/dist/types.d.ts

@@ -1,35 +0,0 @@
-/** Shared shapes the generated module and the runtime both use. */
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-/** Route and policy for one operation, as listed in `OPERATIONS`. */
-export interface OperationMeta {
-    readonly name: string;
-    readonly summary: string;
-    readonly scope: 'organization' | 'project';
-    /** The capability the caller's role needs. */
-    readonly capability: string;
-    /** Destructive operations need `confirm: true` in their input. */
-    readonly destructive: boolean;
-    readonly method: HttpMethod;
-    /** Path under the `/v1` base path; `{name}` segments come from the input. */
-    readonly path: string;
-    readonly pathParams: readonly string[];
-    /** Every error code this operation can return. */
-    readonly errors: readonly string[];
-}
-/** One entry of the error catalog. */
-export interface CloudErrorSpec {
-    readonly status: number;
-    readonly category: string;
-    readonly retryable: boolean;
-    /** The next action, in one sentence. */
-    readonly hint: string;
-    readonly docsUrl: string;
-}
-/** Per-call options for any operation method. */
-export interface CallOptions {
-    /** Abort the request. The fetch's own abort error is rethrown unchanged. */
-    readonly signal?: AbortSignal;
-    /** Extra headers for this call. */
-    readonly headers?: Readonly<Record<string, string>>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD"}

package/dist/types.js

@@ -1,2 +0,0 @@
-/** Shared shapes the generated module and the runtime both use. */
-export {};

package/dist/utils/error-envelope.d.ts

@@ -1,8 +0,0 @@
-import type { CloudErrorBody } from '../errors.js';
-/**
- * Reads Cloud's `{ error: { code, message, ... } }` envelope, or `undefined`
- * when `body` isn't one (a proxy's HTML page, an empty body). Only `code` and
- * `message` are required, so an older or partial envelope still parses.
- */
-export declare function parseErrorEnvelope(body: unknown): CloudErrorBody | undefined;
-//# sourceMappingURL=error-envelope.d.ts.map

package/dist/utils/error-envelope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-envelope.d.ts","sourceRoot":"","sources":["../../src/utils/error-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,cAAc,CAAC;AAepE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAkB5E"}

package/dist/utils/error-envelope.js

@@ -1,34 +0,0 @@
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function readIssues(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    const issues = value.filter((issue) => isRecord(issue) && typeof issue.path === 'string' && typeof issue.message === 'string');
-    return issues.length ? issues.map(({ path, message }) => ({ path, message })) : undefined;
-}
-/**
- * Reads Cloud's `{ error: { code, message, ... } }` envelope, or `undefined`
- * when `body` isn't one (a proxy's HTML page, an empty body). Only `code` and
- * `message` are required, so an older or partial envelope still parses.
- */
-export function parseErrorEnvelope(body) {
-    if (!isRecord(body) || !isRecord(body.error))
-        return undefined;
-    const error = body.error;
-    if (typeof error.code !== 'string' || typeof error.message !== 'string')
-        return undefined;
-    const category = typeof error.category === 'string' ? error.category : 'internal';
-    const issues = readIssues(error.issues);
-    return {
-        code: error.code,
-        message: error.message,
-        hint: typeof error.hint === 'string' ? error.hint : '',
-        docsUrl: typeof error.docsUrl === 'string' ? error.docsUrl : '',
-        category,
-        retryable: error.retryable === true,
-        correctable: typeof error.correctable === 'boolean' ? error.correctable : category === 'correctable_input',
-        requestId: typeof error.requestId === 'string' ? error.requestId : '',
-        ...(issues ? { issues } : {}),
-    };
-}

package/dist/utils/request.d.ts

@@ -1,20 +0,0 @@
-import type { OperationMeta } from '../types.js';
-export interface BuiltRequest {
-    readonly url: string;
-    readonly method: OperationMeta['method'];
-    readonly headers: Record<string, string>;
-    readonly body?: string;
-}
-export interface RequestContext {
-    readonly baseUrl: string;
-    readonly basePath: string;
-    readonly token: string;
-    readonly headers?: Readonly<Record<string, string>>;
-}
-/**
- * The HTTP request for one operation call, matching Cloud's `/v1` handler:
- * path parameters come out of the input, GET and DELETE send the rest as the
- * query string, every other method as a JSON body.
- */
-export declare function buildRequest(operation: OperationMeta, input: Readonly<Record<string, unknown>>, context: RequestContext): BuiltRequest;
-//# sourceMappingURL=request.d.ts.map

package/dist/utils/request.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/utils/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAkBD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,OAAO,EAAE,cAAc,GACtB,YAAY,CA8Bd"}

package/dist/utils/request.js

@@ -1,41 +0,0 @@
-function pathValue(operation, name, value) {
-    if ((typeof value === 'string' && value.length > 0) || typeof value === 'number') {
-        return encodeURIComponent(String(value));
-    }
-    throw new TypeError(`${operation.name}: "${name}" is required (it's part of the path).`);
-}
-function queryValue(operation, name, value) {
-    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-        return String(value);
-    }
-    throw new TypeError(`${operation.name}: "${name}" can't be sent in a query string (only strings, numbers and booleans can).`);
-}
-/**
- * The HTTP request for one operation call, matching Cloud's `/v1` handler:
- * path parameters come out of the input, GET and DELETE send the rest as the
- * query string, every other method as a JSON body.
- */
-export function buildRequest(operation, input, context) {
-    const pathParams = new Set(operation.pathParams);
-    const path = operation.path.replace(/\{([A-Za-z][A-Za-z0-9]*)\}/g, (_, name) => pathValue(operation, name, input[name]));
-    const rest = Object.entries(input).filter(([name, value]) => !pathParams.has(name) && value !== undefined);
-    const url = new URL(`${context.baseUrl.replace(/\/+$/, '')}${context.basePath}${path}`);
-    const headers = {
-        accept: 'application/json',
-        // Lower-cased so a caller's `Authorization` can't sit beside the token.
-        ...Object.fromEntries(Object.entries(context.headers ?? {}).map(([name, value]) => [name.toLowerCase(), value])),
-        authorization: `Bearer ${context.token}`,
-    };
-    if (operation.method === 'GET' || operation.method === 'DELETE') {
-        for (const [name, value] of rest)
-            url.searchParams.set(name, queryValue(operation, name, value));
-        return { url: url.toString(), method: operation.method, headers };
-    }
-    headers['content-type'] = 'application/json';
-    return {
-        url: url.toString(),
-        method: operation.method,
-        headers,
-        body: JSON.stringify(Object.fromEntries(rest)),
-    };
-}