@distilled.cloud/core 0.0.0 → 0.2.0-alpha

package/lib/traits.js

@@ -0,0 +1,470 @@
+/**
+ * Annotation-based traits for declarative operation definitions.
+ *
+ * This module provides a type-safe annotation system for defining HTTP operations
+ * using Schema annotations. Traits can be applied via `.pipe()` or composed with `all()`.
+ *
+ * The annotation system is shared across all SDKs. Individual SDKs can extend it
+ * with provider-specific traits (e.g., AWS Smithy traits, Cloudflare-specific traits).
+ *
+ * @example
+ * ```ts
+ * import * as T from "@distilled.cloud/core/traits";
+ *
+ * const GetDatabaseInput = Schema.Struct({
+ *   organization: Schema.String.pipe(T.PathParam()),
+ *   database: Schema.String.pipe(T.PathParam()),
+ * }).pipe(
+ *   T.Http({ method: "GET", path: "/organizations/{organization}/databases/{database}" })
+ * );
+ * ```
+ */
+import * as Schema from "effect/Schema";
+import * as AST from "effect/SchemaAST";
+// ============================================================================
+// Annotation Primitives
+// ============================================================================
+/**
+ * Internal symbol for annotation metadata storage.
+ */
+const annotationMetaSymbol = Symbol.for("@distilled.cloud/annotation-meta");
+/**
+ * Create an annotation builder for a given symbol and value.
+ * This is the core primitive used to build all trait annotations.
+ */
+export function makeAnnotation(sym, value) {
+    const fn = (schema) => schema.annotate({ [sym]: value });
+    fn[annotationMetaSymbol] = [{ symbol: sym, value }];
+    fn[sym] = value;
+    return fn;
+}
+/**
+ * Combine multiple annotations into one.
+ * Use when you need multiple annotations on the same schema.
+ *
+ * @example
+ * ```ts
+ * const MyInput = Schema.Struct({
+ *   id: Schema.String.pipe(T.all(T.PathParam(), T.Required())),
+ * });
+ * ```
+ */
+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, value } of entries) {
+        fn[symbol] = value;
+    }
+    return fn;
+}
+// =============================================================================
+// HTTP Operation Traits
+// =============================================================================
+/** Symbol for HTTP operation metadata (method + path template) */
+export const httpSymbol = Symbol.for("@distilled.cloud/http");
+/**
+ * Http trait - defines the HTTP method and path template for an operation.
+ * Path parameters are specified using {paramName} syntax.
+ *
+ * @example
+ * ```ts
+ * const GetDatabaseInput = Schema.Struct({
+ *   organization: Schema.String.pipe(T.PathParam()),
+ *   database: Schema.String.pipe(T.PathParam()),
+ * }).pipe(
+ *   T.Http({ method: "GET", path: "/organizations/{organization}/databases/{database}" })
+ * );
+ * ```
+ */
+export const Http = (trait) => makeAnnotation(httpSymbol, trait);
+// =============================================================================
+// Path Parameter Traits
+// =============================================================================
+/** Symbol for path parameter annotation */
+export const pathParamSymbol = Symbol.for("@distilled.cloud/path-param");
+/**
+ * PathParam trait - marks a field as a path parameter.
+ * The field name is used as the placeholder name in the path template.
+ *
+ * @example
+ * ```ts
+ * const Input = Schema.Struct({
+ *   organization: Schema.String.pipe(T.PathParam()),
+ * }).pipe(
+ *   T.Http({ method: "GET", path: "/organizations/{organization}" })
+ * );
+ * ```
+ */
+export const PathParam = () => makeAnnotation(pathParamSymbol, true);
+// =============================================================================
+// Query Parameter Traits
+// =============================================================================
+/** Symbol for query parameter annotation */
+export const queryParamSymbol = Symbol.for("@distilled.cloud/query-param");
+/**
+ * QueryParam trait - marks a field as a query parameter.
+ * Optionally specify a different wire name.
+ *
+ * @example
+ * ```ts
+ * const Input = Schema.Struct({
+ *   perPage: Schema.optional(Schema.Number).pipe(T.QueryParam("per_page")),
+ * });
+ * ```
+ */
+export const QueryParam = (name) => makeAnnotation(queryParamSymbol, name ?? true);
+// =============================================================================
+// Header Parameter Traits
+// =============================================================================
+/** Symbol for header parameter annotation */
+export const headerParamSymbol = Symbol.for("@distilled.cloud/header-param");
+/**
+ * HeaderParam trait - marks a field as a header parameter.
+ * Specify the header name.
+ *
+ * @example
+ * ```ts
+ * const Input = Schema.Struct({
+ *   apiToken: Schema.String.pipe(T.HeaderParam("X-API-Token")),
+ * });
+ * ```
+ */
+export const HeaderParam = (name) => makeAnnotation(headerParamSymbol, name);
+// =============================================================================
+// Convenience Aliases (used by Cloudflare/GCP generators)
+// =============================================================================
+/**
+ * HttpPath - alias for PathParam that also carries the wire name.
+ * Used in generated code: `Schema.String.pipe(T.HttpPath("account_id"))`
+ */
+export const HttpPath = (name) => makeAnnotation(pathParamSymbol, name);
+/**
+ * HttpQuery - alias for QueryParam with an explicit wire name.
+ * Used in generated code: `Schema.optional(Schema.String).pipe(T.HttpQuery("per_page"))`
+ */
+export const HttpQuery = (name) => makeAnnotation(queryParamSymbol, name);
+/**
+ * HttpHeader - alias for HeaderParam.
+ * Used in generated code: `Schema.String.pipe(T.HttpHeader("X-Custom-Header"))`
+ */
+export const HttpHeader = (name) => makeAnnotation(headerParamSymbol, name);
+/** Symbol for HTTP body annotation */
+export const httpBodySymbol = Symbol.for("@distilled.cloud/http-body");
+/**
+ * HttpBody - marks a field as the raw HTTP body.
+ * Used for operations where a field IS the entire request body
+ * (not a named field within a JSON body).
+ */
+export const HttpBody = () => makeAnnotation(httpBodySymbol, true);
+/** Symbol for form data file annotation */
+export const httpFormDataFileSymbol = Symbol.for("@distilled.cloud/http-form-data-file");
+/**
+ * HttpFormDataFile - marks a field as a file upload in multipart form data.
+ */
+export const HttpFormDataFile = () => makeAnnotation(httpFormDataFileSymbol, true);
+// =============================================================================
+// API Error Code Trait
+// =============================================================================
+/** Symbol for API error code mapping */
+export const apiErrorCodeSymbol = Symbol.for("@distilled.cloud/api-error-code");
+/**
+ * ApiErrorCode trait - maps an error class to an API error code.
+ * Used to match API error responses to typed error classes.
+ *
+ * @example
+ * ```ts
+ * class NotFoundError extends Schema.TaggedErrorClass<NotFoundError>()(
+ *   "NotFoundError",
+ *   { message: Schema.String },
+ * ).pipe(T.ApiErrorCode("not_found")) {}
+ * ```
+ */
+export const ApiErrorCode = (code) => makeAnnotation(apiErrorCodeSymbol, code);
+// =============================================================================
+// Service Metadata Trait
+// =============================================================================
+/** Symbol for service metadata */
+export const serviceSymbol = Symbol.for("@distilled.cloud/service");
+/**
+ * Service trait - attaches service metadata to a schema.
+ */
+export const Service = (trait) => makeAnnotation(serviceSymbol, trait);
+// =============================================================================
+// Annotation Retrieval Helpers
+// =============================================================================
+/**
+ * Get annotation value from an AST node, following encoding chain if needed.
+ */
+export const getAnnotation = (ast, symbol) => {
+    // Direct annotation
+    const annotations = ast.annotations;
+    const direct = annotations?.[symbol];
+    if (direct !== undefined)
+        return direct;
+    // Follow encoding chain (replaces v3 Transformation handling)
+    if (ast.encoding && ast.encoding.length > 0) {
+        return getAnnotation(ast.encoding[0].to, symbol);
+    }
+    return undefined;
+};
+/**
+ * Get HTTP trait from a schema's AST.
+ */
+export const getHttpTrait = (ast) => getAnnotation(ast, httpSymbol);
+/**
+ * Check if a PropertySignature has the pathParam annotation.
+ * Works for both PathParam() (annotation value = true) and HttpPath("wire_name") (annotation value = string).
+ */
+export const isPathParam = (prop) => {
+    const value = getAnnotation(prop.type, pathParamSymbol);
+    return value !== undefined;
+};
+/**
+ * Get query param name from a PropertySignature (returns true if unnamed, string if named).
+ */
+export const getQueryParam = (prop) => {
+    return getAnnotation(prop.type, queryParamSymbol);
+};
+/**
+ * Get header param name from a PropertySignature.
+ */
+export const getHeaderParam = (prop) => {
+    return getAnnotation(prop.type, headerParamSymbol);
+};
+/**
+ * Get API error code from an error class AST.
+ */
+export const getApiErrorCode = (ast) => getAnnotation(ast, apiErrorCodeSymbol);
+/**
+ * Get service metadata from a schema's AST.
+ */
+export const getServiceTrait = (ast) => getAnnotation(ast, serviceSymbol);
+/**
+ * Extract path parameters from a schema's struct properties.
+ * Returns an array of field names that have the PathParam annotation.
+ */
+export const getPathParams = (ast) => {
+    // Handle Objects (struct) - v4 renamed from TypeLiteral
+    if (ast._tag === "Objects") {
+        return ast.propertySignatures
+            .filter((prop) => isPathParam(prop))
+            .map((prop) => String(prop.name));
+    }
+    // Follow encoding chain (replaces v3 Transformation handling)
+    if (ast.encoding && ast.encoding.length > 0) {
+        return getPathParams(ast.encoding[0].to);
+    }
+    return [];
+};
+/**
+ * Build the request path by substituting path parameters into the template.
+ * Simple version that assumes input keys match template placeholders.
+ * For schema-aware path building (with camelCase → wire_name mapping), use buildPathFromSchema.
+ */
+export const buildPath = (template, input) => {
+    return template.replace(/\{(\w+)\}/g, (_, name) => {
+        const value = input[name];
+        if (value === undefined || value === null) {
+            throw new Error(`Missing path parameter: ${name}`);
+        }
+        return encodeURIComponent(String(value));
+    });
+};
+/**
+ * Extract AST property signatures from a schema AST, following encoding chain and suspends.
+ */
+export const getStructProps = (ast) => {
+    if (ast.encoding && ast.encoding.length > 0) {
+        return getStructProps(ast.encoding[0].to);
+    }
+    if (ast._tag === "Suspend") {
+        return getStructProps(ast.thunk());
+    }
+    if (ast._tag === "Objects") {
+        return [...ast.propertySignatures];
+    }
+    return [];
+};
+/**
+ * Get the path parameter wire name from a PropertySignature.
+ * - For HttpPath("wire_name"), returns the wire name string.
+ * - For PathParam(), returns the property name (since annotation is `true`).
+ * - Returns undefined if not a path param.
+ */
+export const getPathParamWireName = (prop) => {
+    const value = getAnnotation(prop.type, pathParamSymbol);
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "string")
+        return value;
+    // PathParam() stores `true` — use property name as wire name
+    return String(prop.name);
+};
+/**
+ * Schema-aware request builder. Categorizes input properties into path, query, header,
+ * and body parts using annotations on the schema AST.
+ *
+ * Handles camelCase → wire_name mapping for path params (HttpPath), query params (HttpQuery),
+ * and header params (HttpHeader).
+ *
+ * When `inputSchema` is provided, uses `Schema.encodeSync` to encode the input through the
+ * schema's encoding pipeline (e.g., `encodeKeys` for camelCase → snake_case mapping).
+ * The encoded output is used for body construction, ensuring wire-format key names.
+ */
+export const buildRequestParts = (ast, httpTrait, input, 
+// biome-ignore lint: using any for generic schema parameter
+inputSchema) => {
+    let path = httpTrait.path;
+    const query = {};
+    const headers = {};
+    let rawBody = undefined;
+    let hasRawBody = false;
+    const isMultipart = httpTrait.contentType === "multipart";
+    // Track which TS property names are path/query/header params (not body)
+    const nonBodyKeys = new Set();
+    const props = getStructProps(ast);
+    for (const prop of props) {
+        const tsName = String(prop.name);
+        const value = input[tsName];
+        if (value === undefined || value === null) {
+            continue;
+        }
+        // Path parameter
+        const pathWireName = getPathParamWireName(prop);
+        if (pathWireName !== undefined) {
+            nonBodyKeys.add(tsName);
+            path = path.replace(`{${pathWireName}}`, encodeURIComponent(String(value)));
+            continue;
+        }
+        // Query parameter
+        const queryParam = getQueryParam(prop);
+        if (queryParam !== undefined) {
+            nonBodyKeys.add(tsName);
+            const wireName = typeof queryParam === "string" ? queryParam : tsName;
+            if (Array.isArray(value)) {
+                query[wireName] = value.map(String);
+            }
+            else {
+                query[wireName] = String(value);
+            }
+            continue;
+        }
+        // Header parameter
+        const headerParam = getHeaderParam(prop);
+        if (headerParam !== undefined) {
+            nonBodyKeys.add(tsName);
+            headers[headerParam] = String(value);
+            continue;
+        }
+        // Body field (HttpBody annotation means this IS the entire body)
+        const isBodyField = getAnnotation(prop.type, httpBodySymbol);
+        if (isBodyField) {
+            rawBody = value;
+            hasRawBody = true;
+            nonBodyKeys.add(tsName);
+            continue;
+        }
+    }
+    // Build body from remaining (non-path/query/header) properties
+    let finalBody;
+    if (hasRawBody) {
+        // For HttpBody fields, encode through the schema to get wire-format keys
+        // (e.g., camelCase → snake_case via encodeKeys on nested schemas)
+        if (inputSchema) {
+            const encoded = Schema.encodeSync(inputSchema)(input);
+            const encodedRecord = encoded;
+            // Find the body field name in the encoded output
+            for (const prop of props) {
+                const tsName = String(prop.name);
+                const isBody = getAnnotation(prop.type, httpBodySymbol);
+                if (isBody && encodedRecord[tsName] !== undefined) {
+                    finalBody = encodedRecord[tsName];
+                    break;
+                }
+            }
+            // Fallback to raw body if encoding didn't produce it
+            if (finalBody === undefined) {
+                finalBody = rawBody;
+            }
+        }
+        else {
+            finalBody = rawBody;
+        }
+    }
+    else {
+        // Encode the input through the schema to get wire-format keys
+        // This handles encodeKeys (camelCase → snake_case) and any other encoding transforms
+        if (inputSchema) {
+            const encoded = Schema.encodeSync(inputSchema)(input);
+            const encodedRecord = encoded;
+            // Build a mapping from tsName → encoded key name
+            // by encoding a minimal test object to discover key mappings
+            const bodyFromEncoded = {};
+            let hasBodyFields = false;
+            for (const [key, value] of Object.entries(encodedRecord)) {
+                // Check if this encoded key corresponds to a non-body TS property
+                // by seeing if any non-body prop encodes to this key
+                let isNonBody = false;
+                for (const nbKey of nonBodyKeys) {
+                    // Simple heuristic: if the encoded key matches the non-body key or its encoding
+                    if (key === nbKey) {
+                        isNonBody = true;
+                        break;
+                    }
+                }
+                if (!isNonBody && value !== undefined) {
+                    bodyFromEncoded[key] = value;
+                    hasBodyFields = true;
+                }
+            }
+            finalBody = hasBodyFields ? bodyFromEncoded : undefined;
+        }
+        else {
+            // Fallback: no schema encoding, use TS property names as-is (for backwards compat)
+            const body = {};
+            let hasBody = false;
+            for (const prop of props) {
+                const tsName = String(prop.name);
+                if (nonBodyKeys.has(tsName))
+                    continue;
+                const value = input[tsName];
+                if (value === undefined || value === null)
+                    continue;
+                body[tsName] = value;
+                hasBody = true;
+            }
+            finalBody = hasBody ? body : undefined;
+        }
+    }
+    return {
+        path,
+        query,
+        headers,
+        body: finalBody,
+        isMultipart,
+    };
+};
+/**
+ * Helper to get a value from an object using a dot-separated path.
+ * Used for pagination traits and nested property access.
+ */
+export const getPath = (obj, path) => {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+};
+//# sourceMappingURL=traits.js.map

package/lib/traits.js.map

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

package/package.json

@@ -1,13 +1,80 @@
 {
   "name": "@distilled.cloud/core",
-  "version": "0.0.0",
-  "module": "index.ts",
+  "version": "0.2.0-alpha",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alchemy-run/distilled",
+    "directory": "packages/core"
+  },
   "type": "module",
-  "private": false,
+  "sideEffects": false,
+  "files": [
+    "lib",
+    "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"
+    },
+    "./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"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsgo",
+    "build": "tsgo -b",
+    "fmt": "oxfmt --write src",
+    "lint": "oxlint --fix src",
+    "check": "tsgo && oxlint src && oxfmt --check src",
+    "test": "bunx vitest run test",
+    "publish:npm": "bun run build && bun publish --access public"
+  },
+  "dependencies": {
+    "effect": "4.0.0-beta.25"
+  },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "^1.3.0",
+    "@types/node": "^25.3.5"
   },
   "peerDependencies": {
-    "typescript": "^5"
+    "effect": "4.0.0-beta.25"
   }
 }