@distilled.cloud/core 0.30.3 → 1.0.0-rc.2

package/lib/schema.js

@@ -2,16 +2,15 @@
  * `any`-collapsing re-export of `effect/Schema` for generated service files.
  *
  * This is the single, shared definition consumed by every code-generated
- * provider package (AWS, Azure, Cloudflare, GCP, Kubernetes, …) via
- * `@distilled.cloud/core/schema`. Do not copy it into individual packages.
+ * provider package via `@distilled.cloud/core/schema`. Do not copy it into
+ * individual packages.
  *
  * Every real TYPE (`Schema`, `Codec`, `Top`, …) is re-exported untouched, so
- * the `Schema.Schema<Foo>` / `Schema.Codec<Foo>` annotations on generated
- * consts (and the public `.d.ts`) stay precise. The schema *construction
- * surface* (`Struct`, `optional`, `suspend`, …) and the leaf scalar schemas are
- * retyped to `any`, so the compiler instantiates none of the heavy Schema
- * generics while building a service file — the explicit annotations carry the
- * real types.
+ * the `Schema.Schema<Foo>` annotations on generated consts (and the public
+ * `.d.ts`) stay precise. The schema *construction surface* (`Struct`,
+ * `optional`, `suspend`, …) and the leaf scalar schemas are retyped to `any`,
+ * so the compiler instantiates none of the heavy Schema generics while
+ * building a service file — the explicit annotations carry the real types.
  *
  * Overriding a *value* export never affects the same-named *type* export (they
  * live in separate namespaces and continue to flow through `export *`), so

package/lib/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,cAAc,eAAe,CAAC;AAE9B,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AAInC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,QAAQ,GAAU,CAAC,CAAC,QAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,MAAM,GAAU,CAAC,CAAC,MAAe,CAAC;AAC/C,MAAM,CAAC,MAAM,OAAO,GAAU,CAAC,CAAC,OAAgB,CAAC;AACjD,MAAM,CAAC,MAAM,KAAK,GAAU,CAAC,CAAC,KAAc,CAAC;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAU,CAAC,CAAC,MAAe,CAAC;AAC/C,MAAM,CAAC,MAAM,KAAK,GAAU,CAAC,CAAC,KAAc,CAAC;AAC7C,MAAM,CAAC,MAAM,OAAO,GAAU,CAAC,CAAC,OAAgB,CAAC;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAU,CAAC,CAAC,QAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,MAAM,GAAU,CAAC,CAAC,MAAe,CAAC;AAC/C,MAAM,CAAC,MAAM,KAAK,GAAU,CAAC,CAAC,KAAc,CAAC;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAU,CAAC,CAAC,UAAmB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,CAAC,MAAM,MAAM,GAAQ,CAAC,CAAC,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,MAAM,GAAQ,CAAC,CAAC,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAQ,CAAC,CAAC,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAQ,CAAC,CAAC,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAQ,CAAC,CAAC,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAQ,CAAC,CAAC,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,IAAI,GAAQ,CAAC,CAAC,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,GAAG,GAAQ,CAAC,CAAC,GAAG,CAAC;AAE9B,gFAAgF;AAChF,gFAAgF;AAChF,oCAAoC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,cAAc,eAAe,CAAC;AAE9B,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AAInC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,QAAQ,GAAU,CAAC,CAAC,QAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,MAAM,GAAU,CAAC,CAAC,MAAe,CAAC;AAC/C,MAAM,CAAC,MAAM,OAAO,GAAU,CAAC,CAAC,OAAgB,CAAC;AACjD,MAAM,CAAC,MAAM,KAAK,GAAU,CAAC,CAAC,KAAc,CAAC;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAU,CAAC,CAAC,MAAe,CAAC;AAC/C,MAAM,CAAC,MAAM,KAAK,GAAU,CAAC,CAAC,KAAc,CAAC;AAC7C,MAAM,CAAC,MAAM,OAAO,GAAU,CAAC,CAAC,OAAgB,CAAC;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAU,CAAC,CAAC,QAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,MAAM,GAAU,CAAC,CAAC,MAAe,CAAC;AAC/C,MAAM,CAAC,MAAM,KAAK,GAAU,CAAC,CAAC,KAAc,CAAC;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAU,CAAC,CAAC,UAAmB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,CAAC,MAAM,MAAM,GAAQ,CAAC,CAAC,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,MAAM,GAAQ,CAAC,CAAC,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAQ,CAAC,CAAC,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAQ,CAAC,CAAC,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAQ,CAAC,CAAC,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAQ,CAAC,CAAC,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,IAAI,GAAQ,CAAC,CAAC,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,GAAG,GAAQ,CAAC,CAAC,GAAG,CAAC;AAE9B,gFAAgF;AAChF,gFAAgF;AAChF,oCAAoC"}

package/lib/trait.d.ts

@@ -0,0 +1,150 @@
+export declare const annotationMetaSymbol: unique symbol;
+type Annotatable = {
+    annotate(annotations: any): Annotatable;
+};
+export interface Annotation {
+    <A extends Annotatable>(schema: A): A;
+    readonly [annotationMetaSymbol]: Array<{
+        symbol: symbol | string;
+        value: unknown;
+    }>;
+    readonly [key: symbol]: unknown;
+    readonly [key: string]: unknown;
+}
+/**
+ * Build a pipeable schema annotation carrying `value` under `sym`. Exported
+ * so SDK packages can define their own protocol traits (e.g. cloudflare's
+ * envelope traits, aws's smithy traits) with the same mechanics as the
+ * generic ones here. Keys may be symbols or plain strings — effect Schema
+ * annotation dictionaries accept both.
+ */
+export declare function makeAnnotation<T>(sym: symbol | string, value: T): Annotation;
+/**
+ * Combine several annotations into one — needed where only a single
+ * annotations object can be supplied (e.g. the second argument of
+ * `S.Class`).
+ */
+export declare function all(...annotations: Annotation[]): Annotation;
+export interface HttpTrait {
+    readonly method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+    /** URI template relative to the service base URL, e.g. `/accounts/{account_id}/foo`. */
+    readonly uri: string;
+    /** Default success status code (a `ResponseCode()` member can still read the actual code). */
+    readonly code?: number;
+    /**
+     * Request body encoding. Default is JSON; `"multipart"` sends
+     * multipart/form-data — body members become form parts (objects
+     * JSON-encoded) and members marked `FormDataFile()` append their files.
+     * `"form-urlencoded"` sends application/x-www-form-urlencoded with
+     * Stripe-style bracket notation for nested objects and arrays (see
+     * `buildRequest`).
+     */
+    readonly contentType?: "multipart" | "form-urlencoded";
+    /**
+     * Explicit `Content-Type` for a whole-body (`HttpBody()`) member carrying a
+     * preserialized payload, when the API requires a specific media type rather
+     * than JSON (e.g. `application/x-ndjson` for Vectorize insert/upsert). The
+     * member value is sent verbatim (string/bytes) under this media type.
+     */
+    readonly bodyMediaType?: string;
+    /**
+     * Explicit `Accept` for the operation, when the API serves more than one
+     * response media type. Atlas pins an API version this way (e.g.
+     * `application/vnd.atlas.2024-05-30+json` — `application/json` alone is a
+     * 406). Protocols that don't read it fall back to their own default.
+     */
+    readonly accept?: string;
+}
+export declare const httpSymbol: unique symbol;
+/**
+ * Operation-level HTTP binding: the request method + URI template. Stamped on
+ * the input schema so the protocol can build the request line. URI `{labels}`
+ * are filled from members marked with `Label()`.
+ */
+export declare const Http: (trait: HttpTrait) => Annotation;
+export declare const labelSymbol: unique symbol;
+/** Bind a member to a `{name}` placeholder in the operation's URI template. */
+export declare const Label: (name?: string) => Annotation;
+export declare const responseCodeSymbol: unique symbol;
+export declare const ResponseCode: () => Annotation;
+export declare const headerSymbol: unique symbol;
+export declare const Header: (name?: string) => Annotation;
+export declare const bodySymbol: unique symbol;
+export declare const Body: (name?: string) => Annotation;
+export declare const querySymbol: unique symbol;
+export declare const Query: (name?: string) => Annotation;
+export declare const deepQuerySymbol: unique symbol;
+/**
+ * Binds a struct-valued input member to a family of DOTTED query parameters:
+ * `{ account: { id, name } }` with `DeepQuery("account")` serializes as
+ * `?account.id=…&account.name=…` (null/undefined entries skipped). This is
+ * how several list endpoints model their filters on the wire (e.g.
+ * Cloudflare zones list `account.id` / `account.name`) while the TS surface
+ * keeps the nested-object shape (v0 parity).
+ */
+export declare const DeepQuery: (name?: string) => Annotation;
+export declare const httpBodySymbol: unique symbol;
+/**
+ * Marks the input member whose value IS the entire request body (raw arrays/
+ * scalars — e.g. endpoints that POST a bare JSON array). Mirrors
+ * `smithy.api#httpPayload`.
+ */
+export declare const HttpBody: () => Annotation;
+export declare const formDataFileSymbol: unique symbol;
+/**
+ * Marks an input member holding `File`/`Blob` parts for a multipart upload
+ * (`Http({ contentType: "multipart" })`). Each file is appended to the form
+ * under its own filename.
+ */
+export declare const FormDataFile: () => Annotation;
+export declare const keyDictionarySymbol: unique symbol;
+/**
+ * Deep TS-name→wire-name key dictionary for members whose full structure is
+ * not modeled (opaque `Document` content). The protocol renames any matching
+ * key at any depth on encode (and the reverse on decode); keys not in the
+ * dictionary pass through verbatim.
+ *
+ * A value may be an array of wire names when the API itself is inconsistent
+ * (e.g. queues consumer responses name the worker script `script_name` on
+ * create/update but `script` on get/list): the first entry is the canonical
+ * wire name used on encode; decode maps every listed spelling back to the
+ * TS name.
+ */
+export type KeyDictionaryEntries = Record<string, string | ReadonlyArray<string>>;
+export declare const KeyDictionary: (dict: KeyDictionaryEntries) => Annotation;
+export declare const unionCasesSymbol: unique symbol;
+/**
+ * Marks an opaque schema standing in for a discriminated union of object
+ * cases, carrying each case's TS-facing key set. For APIs that return every
+ * case's keys with `null` for the inactive ones, the protocol uses these key
+ * sets to pick the active case and drop the others, so consumers' `"key" in
+ * value` discrimination works.
+ */
+export declare const UnionCases: (cases: ReadonlyArray<ReadonlyArray<string>>) => Annotation;
+export declare const errorMatchersSymbol: unique symbol;
+/**
+ * One wire-matching rule for a typed error class. A matcher matches a wire
+ * failure when every present field matches: `code` equals the wire error's
+ * code, `status` equals the HTTP status, and `message` either equals the
+ * error message (string form) or satisfies `includes` (substring) /
+ * `matches` (regex). A matcher with no fields matches nothing.
+ */
+export interface ErrorMatcher {
+    readonly code?: number;
+    readonly status?: number;
+    readonly message?: string | {
+        readonly includes?: string;
+        readonly matches?: string;
+    };
+}
+/**
+ * Stamp wire-matching rules onto a generated error class. Protocols consult
+ * these to decide which of an operation's declared error classes a failed
+ * response should surface as (most specific matcher wins; ties break by
+ * declaration order — see `matchTypedError` in `core/protocol-http`).
+ */
+export declare const applyErrorMatchers: <C>(cls: C, matchers: ReadonlyArray<ErrorMatcher>) => C;
+/** Read the matchers stamped on an error class, if any. */
+export declare const getErrorMatchers: (cls: unknown) => ReadonlyArray<ErrorMatcher> | undefined;
+export {};
+//# sourceMappingURL=trait.d.ts.map

package/lib/trait.d.ts.map

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

package/lib/trait.js

@@ -0,0 +1,107 @@
+export const annotationMetaSymbol = Symbol.for("@distilled.cloud/core/annotation-meta");
+/**
+ * Build a pipeable schema annotation carrying `value` under `sym`. Exported
+ * so SDK packages can define their own protocol traits (e.g. cloudflare's
+ * envelope traits, aws's smithy traits) with the same mechanics as the
+ * generic ones here. Keys may be symbols or plain strings — effect Schema
+ * annotation dictionaries accept both.
+ */
+export function makeAnnotation(sym, value) {
+    const fn = (schema) => schema.annotate({ [sym]: value });
+    fn[annotationMetaSymbol] = [{ symbol: sym, value }];
+    fn[sym] = value;
+    return fn;
+}
+/**
+ * Combine several annotations into one — needed where only a single
+ * annotations object can be supplied (e.g. the second argument of
+ * `S.Class`).
+ */
+export function all(...annotations) {
+    const entries = [];
+    const raw = {};
+    for (const a of annotations) {
+        for (const entry of a[annotationMetaSymbol]) {
+            entries.push(entry);
+            raw[entry.symbol] = entry.value;
+        }
+    }
+    const fn = (schema) => schema.annotate(raw);
+    fn[annotationMetaSymbol] = entries;
+    for (const { symbol: sym, value } of entries) {
+        fn[sym] = value;
+    }
+    return fn;
+}
+export const httpSymbol = Symbol.for("@distilled.cloud/core/http");
+/**
+ * Operation-level HTTP binding: the request method + URI template. Stamped on
+ * the input schema so the protocol can build the request line. URI `{labels}`
+ * are filled from members marked with `Label()`.
+ */
+export const Http = (trait) => makeAnnotation(httpSymbol, trait);
+export const labelSymbol = Symbol.for("@distilled.cloud/core/http/label");
+/** Bind a member to a `{name}` placeholder in the operation's URI template. */
+export const Label = (name) => makeAnnotation(labelSymbol, name ?? true);
+export const responseCodeSymbol = Symbol.for("@distilled.cloud/core/http/response-code");
+export const ResponseCode = () => makeAnnotation(responseCodeSymbol, true);
+export const headerSymbol = Symbol.for("@distilled.cloud/core/http/header");
+export const Header = (name) => makeAnnotation(headerSymbol, name ?? true);
+export const bodySymbol = Symbol.for("@distilled.cloud/core/http/body");
+export const Body = (name) => makeAnnotation(bodySymbol, name ?? true);
+export const querySymbol = Symbol.for("@distilled.cloud/core/http/query");
+export const Query = (name) => makeAnnotation(querySymbol, name ?? true);
+export const deepQuerySymbol = Symbol.for("@distilled.cloud/core/http/deep-query");
+/**
+ * Binds a struct-valued input member to a family of DOTTED query parameters:
+ * `{ account: { id, name } }` with `DeepQuery("account")` serializes as
+ * `?account.id=…&account.name=…` (null/undefined entries skipped). This is
+ * how several list endpoints model their filters on the wire (e.g.
+ * Cloudflare zones list `account.id` / `account.name`) while the TS surface
+ * keeps the nested-object shape (v0 parity).
+ */
+export const DeepQuery = (name) => makeAnnotation(deepQuerySymbol, name ?? true);
+export const httpBodySymbol = Symbol.for("@distilled.cloud/core/http-body");
+/**
+ * Marks the input member whose value IS the entire request body (raw arrays/
+ * scalars — e.g. endpoints that POST a bare JSON array). Mirrors
+ * `smithy.api#httpPayload`.
+ */
+export const HttpBody = () => makeAnnotation(httpBodySymbol, true);
+export const formDataFileSymbol = Symbol.for("@distilled.cloud/core/form-data-file");
+/**
+ * Marks an input member holding `File`/`Blob` parts for a multipart upload
+ * (`Http({ contentType: "multipart" })`). Each file is appended to the form
+ * under its own filename.
+ */
+export const FormDataFile = () => makeAnnotation(formDataFileSymbol, true);
+//#endregion
+//#region Generic JSON traits
+export const keyDictionarySymbol = Symbol.for("@distilled.cloud/core/key-dictionary");
+export const KeyDictionary = (dict) => makeAnnotation(keyDictionarySymbol, dict);
+export const unionCasesSymbol = Symbol.for("@distilled.cloud/core/union-cases");
+/**
+ * Marks an opaque schema standing in for a discriminated union of object
+ * cases, carrying each case's TS-facing key set. For APIs that return every
+ * case's keys with `null` for the inactive ones, the protocol uses these key
+ * sets to pick the active case and drop the others, so consumers' `"key" in
+ * value` discrimination works.
+ */
+export const UnionCases = (cases) => makeAnnotation(unionCasesSymbol, cases);
+//#endregion
+//#region Error matcher traits
+export const errorMatchersSymbol = Symbol.for("@distilled.cloud/core/error-matchers");
+/**
+ * Stamp wire-matching rules onto a generated error class. Protocols consult
+ * these to decide which of an operation's declared error classes a failed
+ * response should surface as (most specific matcher wins; ties break by
+ * declaration order — see `matchTypedError` in `core/protocol-http`).
+ */
+export const applyErrorMatchers = (cls, matchers) => {
+    cls[errorMatchersSymbol] = matchers;
+    return cls;
+};
+/** Read the matchers stamped on an error class, if any. */
+export const getErrorMatchers = (cls) => cls?.[errorMatchersSymbol];
+//#endregion
+//# sourceMappingURL=trait.js.map

package/lib/trait.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@distilled.cloud/core",
-  "version": "0.30.3",
+  "version": "1.0.0-rc.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/alchemy-run/distilled",
@@ -14,86 +14,29 @@
     "src"
   ],
   "exports": {
-    "./category": {
-      "types": "./lib/category.d.ts",
-      "bun": "./src/category.ts",
-      "default": "./lib/category.js"
-    },
-    "./client": {
-      "types": "./lib/client.d.ts",
-      "bun": "./src/client.ts",
-      "default": "./lib/client.js"
-    },
-    "./errors": {
-      "types": "./lib/errors.d.ts",
-      "bun": "./src/errors.ts",
-      "default": "./lib/errors.js"
-    },
-    "./json-patch": {
-      "types": "./lib/json-patch.d.ts",
-      "bun": "./src/json-patch.ts",
-      "default": "./lib/json-patch.js"
-    },
-    "./pagination": {
-      "types": "./lib/pagination.d.ts",
-      "bun": "./src/pagination.ts",
-      "default": "./lib/pagination.js"
-    },
-    "./retry": {
-      "types": "./lib/retry.d.ts",
-      "bun": "./src/retry.ts",
-      "default": "./lib/retry.js"
-    },
-    "./retry-after": {
-      "types": "./lib/retry-after.d.ts",
-      "bun": "./src/retry-after.ts",
-      "default": "./lib/retry-after.js"
-    },
-    "./schema": {
-      "types": "./lib/schema.d.ts",
-      "bun": "./src/schema.ts",
-      "default": "./lib/schema.js"
-    },
-    "./schemas": {
-      "types": "./lib/schemas.d.ts",
-      "bun": "./src/schemas.ts",
-      "default": "./lib/schemas.js"
-    },
-    "./sensitive": {
-      "types": "./lib/sensitive.d.ts",
-      "bun": "./src/sensitive.ts",
-      "default": "./lib/sensitive.js"
-    },
-    "./traits": {
-      "types": "./lib/traits.d.ts",
-      "bun": "./src/traits.ts",
-      "default": "./lib/traits.js"
-    },
-    "./openapi/generate": {
-      "bun": "./scripts/generate-openapi.ts",
-      "default": "./scripts/generate-openapi.ts"
-    },
-    "./graphql/generate": {
-      "bun": "./scripts/generate-graphql.ts",
-      "default": "./scripts/generate-graphql.ts"
+    ".": {
+      "types": "./lib/index.d.ts",
+      "bun": "./src/index.ts",
+      "worker": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./*": {
+      "types": "./lib/*.d.ts",
+      "bun": "./src/*.ts",
+      "worker": "./src/*.ts",
+      "import": "./lib/*.js"
     }
   },
   "scripts": {
-    "typecheck": "tsc",
-    "build": "tsc -b",
-    "fmt": "oxfmt --write src",
-    "lint": "oxlint --fix src",
-    "check": "tsc && oxlint src && oxfmt --check src",
-    "test": "bunx vitest run test --exclude specs --passWithNoTests",
-    "publish:npm": "bun run build && bun publish --access public"
+    "build": "tsc -b"
   },
   "devDependencies": {
-    "@types/bun": "^1.3.0",
-    "@types/node": "^25.3.5",
-    "dotenv": "^16.5.0",
-    "vitest": "^3.2.3"
+    "@effect/platform-bun": ">=4.0.0-beta.102 || >=4.0.0",
+    "@types/bun": "latest",
+    "@types/node": "latest",
+    "effect": ">=4.0.0-beta.102 || >=4.0.0"
   },
   "peerDependencies": {
-    "effect": ">=4.0.0-beta.100 || >=4.0.0"
+    "effect": ">=4.0.0-beta.102 || >=4.0.0"
   }
 }