@spare-technologies/spare-api 1.0.0-beta.7

package/dist/core/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../core/logging/logger.ts"],"names":[],"mappings":"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","sourcesContent":["export const LogLevel = {\n    Debug: \"debug\",\n    Info: \"info\",\n    Warn: \"warn\",\n    Error: \"error\",\n} as const;\nexport type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];\nconst logLevelMap: Record<LogLevel, number> = {\n    [LogLevel.Debug]: 1,\n    [LogLevel.Info]: 2,\n    [LogLevel.Warn]: 3,\n    [LogLevel.Error]: 4,\n};\n\nexport interface ILogger {\n    /**\n     * Logs a debug message.\n     * @param message - The message to log\n     * @param args - Additional arguments to log\n     */\n    debug(message: string, ...args: unknown[]): void;\n    /**\n     * Logs an info message.\n     * @param message - The message to log\n     * @param args - Additional arguments to log\n     */\n    info(message: string, ...args: unknown[]): void;\n    /**\n     * Logs a warning message.\n     * @param message - The message to log\n     * @param args - Additional arguments to log\n     */\n    warn(message: string, ...args: unknown[]): void;\n    /**\n     * Logs an error message.\n     * @param message - The message to log\n     * @param args - Additional arguments to log\n     */\n    error(message: string, ...args: unknown[]): void;\n}\n\n/**\n * Configuration for logger initialization.\n */\nexport interface LogConfig {\n    /**\n     * Minimum log level to output.\n     * @default LogLevel.Info\n     */\n    level?: LogLevel;\n    /**\n     * Logger implementation to use.\n     * @default new ConsoleLogger()\n     */\n    logger?: ILogger;\n    /**\n     * Whether logging should be silenced.\n     * @default true\n     */\n    silent?: boolean;\n}\n\n/**\n * Default console-based logger implementation.\n */\nexport class ConsoleLogger implements ILogger {\n    debug(message: string, ...args: unknown[]): void {\n        console.debug(message, ...args);\n    }\n    info(message: string, ...args: unknown[]): void {\n        console.info(message, ...args);\n    }\n    warn(message: string, ...args: unknown[]): void {\n        console.warn(message, ...args);\n    }\n    error(message: string, ...args: unknown[]): void {\n        console.error(message, ...args);\n    }\n}\n\n/**\n * Logger class that provides level-based logging functionality.\n */\nexport class Logger {\n    private readonly level: number;\n    private readonly logger: ILogger;\n    private readonly silent: boolean;\n\n    /**\n     * Creates a new logger instance.\n     * @param config - Logger configuration\n     */\n    constructor(config: Required<LogConfig>) {\n        this.level = logLevelMap[config.level];\n        this.logger = config.logger;\n        this.silent = config.silent;\n    }\n\n    /**\n     * Checks if a log level should be output based on configuration.\n     * @param level - The log level to check\n     * @returns True if the level should be logged\n     */\n    public shouldLog(level: LogLevel): boolean {\n        return !this.silent && this.level <= logLevelMap[level];\n    }\n\n    /**\n     * Checks if debug logging is enabled.\n     * @returns True if debug logs should be output\n     */\n    public isDebug(): boolean {\n        return this.shouldLog(LogLevel.Debug);\n    }\n\n    /**\n     * Logs a debug message if debug logging is enabled.\n     * @param message - The message to log\n     * @param args - Additional arguments to log\n     */\n    public debug(message: string, ...args: unknown[]): void {\n        if (this.isDebug()) {\n            this.logger.debug(message, ...args);\n        }\n    }\n\n    /**\n     * Checks if info logging is enabled.\n     * @returns True if info logs should be output\n     */\n    public isInfo(): boolean {\n        return this.shouldLog(LogLevel.Info);\n    }\n\n    /**\n     * Logs an info message if info logging is enabled.\n     * @param message - The message to log\n     * @param args - Additional arguments to log\n     */\n    public info(message: string, ...args: unknown[]): void {\n        if (this.isInfo()) {\n            this.logger.info(message, ...args);\n        }\n    }\n\n    /**\n     * Checks if warning logging is enabled.\n     * @returns True if warning logs should be output\n     */\n    public isWarn(): boolean {\n        return this.shouldLog(LogLevel.Warn);\n    }\n\n    /**\n     * Logs a warning message if warning logging is enabled.\n     * @param message - The message to log\n     * @param args - Additional arguments to log\n     */\n    public warn(message: string, ...args: unknown[]): void {\n        if (this.isWarn()) {\n            this.logger.warn(message, ...args);\n        }\n    }\n\n    /**\n     * Checks if error logging is enabled.\n     * @returns True if error logs should be output\n     */\n    public isError(): boolean {\n        return this.shouldLog(LogLevel.Error);\n    }\n\n    /**\n     * Logs an error message if error logging is enabled.\n     * @param message - The message to log\n     * @param args - Additional arguments to log\n     */\n    public error(message: string, ...args: unknown[]): void {\n        if (this.isError()) {\n            this.logger.error(message, ...args);\n        }\n    }\n}\n\nexport function createLogger(config?: LogConfig | Logger): Logger {\n    if (config == null) {\n        return defaultLogger;\n    }\n    if (config instanceof Logger) {\n        return config;\n    }\n    config = config ?? {};\n    config.level ??= LogLevel.Info;\n    config.logger ??= new ConsoleLogger();\n    config.silent ??= true;\n    return new Logger(config as Required<LogConfig>);\n}\n\nconst defaultLogger: Logger = new Logger({\n    level: LogLevel.Info,\n    logger: new ConsoleLogger(),\n    silent: true,\n});\n"]}

package/dist/core/runtime/index.d.ts

@@ -0,0 +1,2 @@
+export { RUNTIME } from "./runtime.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/runtime/index.js

@@ -0,0 +1,2 @@
+export { RUNTIME } from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/core/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { RUNTIME } from \"./runtime.js\";\n"]}

package/dist/core/runtime/runtime.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A constant that indicates which environment and version the SDK is running in.
+ */
+export declare const RUNTIME: Runtime;
+export interface Runtime {
+    type: "browser" | "web-worker" | "deno" | "bun" | "node" | "react-native" | "unknown" | "workerd" | "edge-runtime";
+    version?: string;
+    parsedVersion?: number;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../core/runtime/runtime.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,OAA2B,CAAC;AAElD,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;IACnH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/core/runtime/runtime.js

@@ -0,0 +1,101 @@
+/**
+ * A constant that indicates which environment and version the SDK is running in.
+ */
+export const RUNTIME = evaluateRuntime();
+function evaluateRuntime() {
+    /**
+     * A constant that indicates whether the environment the code is running is a Web Browser.
+     */
+    const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+    if (isBrowser) {
+        return {
+            type: "browser",
+            version: window.navigator.userAgent,
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Cloudflare.
+     * https://developers.cloudflare.com/workers/runtime-apis/web-standards/#navigatoruseragent
+     */
+    const isCloudflare = typeof globalThis !== "undefined" && globalThis?.navigator?.userAgent === "Cloudflare-Workers";
+    if (isCloudflare) {
+        return {
+            type: "workerd",
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Edge Runtime.
+     * https://vercel.com/docs/functions/runtimes/edge-runtime#check-if-you're-running-on-the-edge-runtime
+     */
+    const isEdgeRuntime = typeof EdgeRuntime === "string";
+    if (isEdgeRuntime) {
+        return {
+            type: "edge-runtime",
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is a Web Worker.
+     */
+    const isWebWorker = typeof self === "object" &&
+        typeof self?.importScripts === "function" &&
+        (self.constructor?.name === "DedicatedWorkerGlobalScope" ||
+            self.constructor?.name === "ServiceWorkerGlobalScope" ||
+            self.constructor?.name === "SharedWorkerGlobalScope");
+    if (isWebWorker) {
+        return {
+            type: "web-worker",
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Deno.
+     * FYI Deno spoofs process.versions.node, see https://deno.land/std@0.177.0/node/process.ts?s=versions
+     */
+    const isDeno = typeof Deno !== "undefined" && typeof Deno.version !== "undefined" && typeof Deno.version.deno !== "undefined";
+    if (isDeno) {
+        return {
+            type: "deno",
+            version: Deno.version.deno,
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Bun.sh.
+     */
+    const isBun = typeof Bun !== "undefined" && typeof Bun.version !== "undefined";
+    if (isBun) {
+        return {
+            type: "bun",
+            version: Bun.version,
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is in React-Native.
+     * This check should come before Node.js detection since React Native may have a process polyfill.
+     * https://github.com/facebook/react-native/blob/main/packages/react-native/Libraries/Core/setUpNavigator.js
+     */
+    const isReactNative = typeof navigator !== "undefined" && navigator?.product === "ReactNative";
+    if (isReactNative) {
+        return {
+            type: "react-native",
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Node.JS.
+     *
+     * We assign `process` to a local variable first to avoid being flagged by
+     * bundlers that perform static analysis on `process.versions` (e.g. Next.js
+     * Edge Runtime warns about Node.js APIs even when they are guarded).
+     */
+    const _process = typeof process !== "undefined" ? process : undefined;
+    const isNode = typeof _process !== "undefined" && typeof _process.versions?.node === "string";
+    if (isNode) {
+        return {
+            type: "node",
+            version: _process.versions.node,
+            parsedVersion: Number(_process.versions.node.split(".")[0]),
+        };
+    }
+    return {
+        type: "unknown",
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../core/runtime/runtime.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAY,eAAe,EAAE,CAAC;AAQlD,SAAS,eAAe;IACpB;;OAEG;IACH,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW,CAAC;IAC1F,IAAI,SAAS,EAAE,CAAC;QACZ,OAAO;YACH,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS;SACtC,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,MAAM,YAAY,GAAG,OAAO,UAAU,KAAK,WAAW,IAAI,UAAU,EAAE,SAAS,EAAE,SAAS,KAAK,oBAAoB,CAAC;IACpH,IAAI,YAAY,EAAE,CAAC;QACf,OAAO;YACH,IAAI,EAAE,SAAS;SAClB,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,MAAM,aAAa,GAAG,OAAO,WAAW,KAAK,QAAQ,CAAC;IACtD,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO;YACH,IAAI,EAAE,cAAc;SACvB,CAAC;IACN,CAAC;IAED;;OAEG;IACH,MAAM,WAAW,GACb,OAAO,IAAI,KAAK,QAAQ;QACxB,OAAO,IAAI,EAAE,aAAa,KAAK,UAAU;QACzC,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,4BAA4B;YACpD,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,0BAA0B;YACrD,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,yBAAyB,CAAC,CAAC;IAC9D,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;YACH,IAAI,EAAE,YAAY;SACrB,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,MAAM,MAAM,GACR,OAAO,IAAI,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC;IACnH,IAAI,MAAM,EAAE,CAAC;QACT,OAAO;YACH,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;SAC7B,CAAC;IACN,CAAC;IAED;;OAEG;IACH,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,WAAW,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,WAAW,CAAC;IAC/E,IAAI,KAAK,EAAE,CAAC;QACR,OAAO;YACH,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,GAAG,CAAC,OAAO;SACvB,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,MAAM,aAAa,GAAG,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,EAAE,OAAO,KAAK,aAAa,CAAC;IAC/F,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO;YACH,IAAI,EAAE,cAAc;SACvB,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACH,MAAM,QAAQ,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAAC;IAC9F,IAAI,MAAM,EAAE,CAAC;QACT,OAAO;YACH,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;YAC/B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC9D,CAAC;IACN,CAAC;IAED,OAAO;QACH,IAAI,EAAE,SAAS;KAClB,CAAC;AACN,CAAC","sourcesContent":["interface DenoGlobal {\n    version: {\n        deno: string;\n    };\n}\n\ninterface BunGlobal {\n    version: string;\n}\n\ndeclare const Deno: DenoGlobal | undefined;\ndeclare const Bun: BunGlobal | undefined;\ndeclare const EdgeRuntime: string | undefined;\ndeclare const self: typeof globalThis.self & {\n    importScripts?: unknown;\n};\n\n/**\n * A constant that indicates which environment and version the SDK is running in.\n */\nexport const RUNTIME: Runtime = evaluateRuntime();\n\nexport interface Runtime {\n    type: \"browser\" | \"web-worker\" | \"deno\" | \"bun\" | \"node\" | \"react-native\" | \"unknown\" | \"workerd\" | \"edge-runtime\";\n    version?: string;\n    parsedVersion?: number;\n}\n\nfunction evaluateRuntime(): Runtime {\n    /**\n     * A constant that indicates whether the environment the code is running is a Web Browser.\n     */\n    const isBrowser = typeof window !== \"undefined\" && typeof window.document !== \"undefined\";\n    if (isBrowser) {\n        return {\n            type: \"browser\",\n            version: window.navigator.userAgent,\n        };\n    }\n\n    /**\n     * A constant that indicates whether the environment the code is running is Cloudflare.\n     * https://developers.cloudflare.com/workers/runtime-apis/web-standards/#navigatoruseragent\n     */\n    const isCloudflare = typeof globalThis !== \"undefined\" && globalThis?.navigator?.userAgent === \"Cloudflare-Workers\";\n    if (isCloudflare) {\n        return {\n            type: \"workerd\",\n        };\n    }\n\n    /**\n     * A constant that indicates whether the environment the code is running is Edge Runtime.\n     * https://vercel.com/docs/functions/runtimes/edge-runtime#check-if-you're-running-on-the-edge-runtime\n     */\n    const isEdgeRuntime = typeof EdgeRuntime === \"string\";\n    if (isEdgeRuntime) {\n        return {\n            type: \"edge-runtime\",\n        };\n    }\n\n    /**\n     * A constant that indicates whether the environment the code is running is a Web Worker.\n     */\n    const isWebWorker =\n        typeof self === \"object\" &&\n        typeof self?.importScripts === \"function\" &&\n        (self.constructor?.name === \"DedicatedWorkerGlobalScope\" ||\n            self.constructor?.name === \"ServiceWorkerGlobalScope\" ||\n            self.constructor?.name === \"SharedWorkerGlobalScope\");\n    if (isWebWorker) {\n        return {\n            type: \"web-worker\",\n        };\n    }\n\n    /**\n     * A constant that indicates whether the environment the code is running is Deno.\n     * FYI Deno spoofs process.versions.node, see https://deno.land/std@0.177.0/node/process.ts?s=versions\n     */\n    const isDeno =\n        typeof Deno !== \"undefined\" && typeof Deno.version !== \"undefined\" && typeof Deno.version.deno !== \"undefined\";\n    if (isDeno) {\n        return {\n            type: \"deno\",\n            version: Deno.version.deno,\n        };\n    }\n\n    /**\n     * A constant that indicates whether the environment the code is running is Bun.sh.\n     */\n    const isBun = typeof Bun !== \"undefined\" && typeof Bun.version !== \"undefined\";\n    if (isBun) {\n        return {\n            type: \"bun\",\n            version: Bun.version,\n        };\n    }\n\n    /**\n     * A constant that indicates whether the environment the code is running is in React-Native.\n     * This check should come before Node.js detection since React Native may have a process polyfill.\n     * https://github.com/facebook/react-native/blob/main/packages/react-native/Libraries/Core/setUpNavigator.js\n     */\n    const isReactNative = typeof navigator !== \"undefined\" && navigator?.product === \"ReactNative\";\n    if (isReactNative) {\n        return {\n            type: \"react-native\",\n        };\n    }\n\n    /**\n     * A constant that indicates whether the environment the code is running is Node.JS.\n     *\n     * We assign `process` to a local variable first to avoid being flagged by\n     * bundlers that perform static analysis on `process.versions` (e.g. Next.js\n     * Edge Runtime warns about Node.js APIs even when they are guarded).\n     */\n    const _process = typeof process !== \"undefined\" ? process : undefined;\n    const isNode = typeof _process !== \"undefined\" && typeof _process.versions?.node === \"string\";\n    if (isNode) {\n        return {\n            type: \"node\",\n            version: _process.versions.node,\n            parsedVersion: Number(_process.versions.node.split(\".\")[0]),\n        };\n    }\n\n    return {\n        type: \"unknown\",\n    };\n}\n"]}

package/dist/core/url/QueryStringBuilder.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Creates a fluent builder for constructing URL query strings.
+ *
+ * Each `.add()` call serializes its value immediately (like C#'s builder),
+ * so no format tracking is needed — the style is applied at add-time.
+ *
+ * Usage (generated code):
+ *
+ *     const qs = core.url.queryBuilder()
+ *         .add("limit", limit)
+ *         .add("tags", tags, { style: "comma" })   // explode: false
+ *         .mergeAdditional(requestOptions?.queryParams)
+ *         .build();
+ */
+export declare function queryBuilder(): QueryStringBuilder;
+declare class QueryStringBuilder {
+    private parts;
+    /**
+     * Adds a query parameter, serializing it immediately.
+     *
+     * By default arrays use "repeat" format (`key=a&key=b`).
+     * Pass `{ style: "comma" }` for OpenAPI `explode: false` parameters
+     * to get comma-separated values (`key=a,b,c`).
+     *
+     * Null / undefined values are silently skipped.
+     */
+    add(key: string, value: unknown, options?: {
+        style?: "comma";
+    }): this;
+    /**
+     * Adds multiple query parameters at once from a record.
+     * All parameters use the default "repeat" array format.
+     * Null / undefined values are silently skipped.
+     */
+    addMany(params: Record<string, unknown>): this;
+    /**
+     * Merges additional query parameters supplied at call-time via
+     * `requestOptions.queryParams`. Overrides existing keys (last-write-wins).
+     */
+    mergeAdditional(additionalParams?: Record<string, unknown>): this;
+    /**
+     * Returns the assembled query string (without the leading `?`).
+     * Returns an empty string when no parameters were added.
+     */
+    build(): string;
+}
+export {};
+//# sourceMappingURL=QueryStringBuilder.d.ts.map

package/dist/core/url/QueryStringBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryStringBuilder.d.ts","sourceRoot":"","sources":["../../../core/url/QueryStringBuilder.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,kBAAkB,CAEjD;AAED,cAAM,kBAAkB;IACpB,OAAO,CAAC,KAAK,CAAkC;IAE/C;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAcrE;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS9C;;;OAGG;IACH,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAejE;;;OAGG;IACH,KAAK,IAAI,MAAM;CAGlB"}

package/dist/core/url/QueryStringBuilder.js

@@ -0,0 +1,81 @@
+import { toQueryString } from "./qs.js";
+/**
+ * Creates a fluent builder for constructing URL query strings.
+ *
+ * Each `.add()` call serializes its value immediately (like C#'s builder),
+ * so no format tracking is needed — the style is applied at add-time.
+ *
+ * Usage (generated code):
+ *
+ *     const qs = core.url.queryBuilder()
+ *         .add("limit", limit)
+ *         .add("tags", tags, { style: "comma" })   // explode: false
+ *         .mergeAdditional(requestOptions?.queryParams)
+ *         .build();
+ */
+export function queryBuilder() {
+    return new QueryStringBuilder();
+}
+class QueryStringBuilder {
+    constructor() {
+        this.parts = new Map();
+    }
+    /**
+     * Adds a query parameter, serializing it immediately.
+     *
+     * By default arrays use "repeat" format (`key=a&key=b`).
+     * Pass `{ style: "comma" }` for OpenAPI `explode: false` parameters
+     * to get comma-separated values (`key=a,b,c`).
+     *
+     * Null / undefined values are silently skipped.
+     */
+    add(key, value, options) {
+        if (value === undefined || value === null) {
+            return this;
+        }
+        const serialized = toQueryString({ [key]: value }, { arrayFormat: options?.style === "comma" ? "comma" : "repeat" });
+        if (serialized.length > 0) {
+            this.parts.set(key, serialized);
+        }
+        return this;
+    }
+    /**
+     * Adds multiple query parameters at once from a record.
+     * All parameters use the default "repeat" array format.
+     * Null / undefined values are silently skipped.
+     */
+    addMany(params) {
+        if (params != null) {
+            for (const [key, value] of Object.entries(params)) {
+                this.add(key, value);
+            }
+        }
+        return this;
+    }
+    /**
+     * Merges additional query parameters supplied at call-time via
+     * `requestOptions.queryParams`. Overrides existing keys (last-write-wins).
+     */
+    mergeAdditional(additionalParams) {
+        if (additionalParams != null) {
+            for (const [key, value] of Object.entries(additionalParams)) {
+                if (value === undefined || value === null) {
+                    continue;
+                }
+                const serialized = toQueryString({ [key]: value }, { arrayFormat: "repeat" });
+                if (serialized.length > 0) {
+                    this.parts.set(key, serialized);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * Returns the assembled query string (without the leading `?`).
+     * Returns an empty string when no parameters were added.
+     */
+    build() {
+        return [...this.parts.values()].join("&");
+    }
+}
+//# sourceMappingURL=QueryStringBuilder.js.map

package/dist/core/url/QueryStringBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryStringBuilder.js","sourceRoot":"","sources":["../../../core/url/QueryStringBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY;IACxB,OAAO,IAAI,kBAAkB,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,kBAAkB;IAAxB;QACY,UAAK,GAAwB,IAAI,GAAG,EAAE,CAAC;IAiEnD,CAAC;IA/DG;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,OAA6B;QAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAC5B,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAChB,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CACnE,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,MAA+B;QACnC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzB,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,gBAA0C;QACtD,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACxC,SAAS;gBACb,CAAC;gBACD,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC9E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;gBACpC,CAAC;YACL,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;CACJ","sourcesContent":["import { toQueryString } from \"./qs.js\";\n\n/**\n * Creates a fluent builder for constructing URL query strings.\n *\n * Each `.add()` call serializes its value immediately (like C#'s builder),\n * so no format tracking is needed — the style is applied at add-time.\n *\n * Usage (generated code):\n *\n *     const qs = core.url.queryBuilder()\n *         .add(\"limit\", limit)\n *         .add(\"tags\", tags, { style: \"comma\" })   // explode: false\n *         .mergeAdditional(requestOptions?.queryParams)\n *         .build();\n */\nexport function queryBuilder(): QueryStringBuilder {\n    return new QueryStringBuilder();\n}\n\nclass QueryStringBuilder {\n    private parts: Map<string, string> = new Map();\n\n    /**\n     * Adds a query parameter, serializing it immediately.\n     *\n     * By default arrays use \"repeat\" format (`key=a&key=b`).\n     * Pass `{ style: \"comma\" }` for OpenAPI `explode: false` parameters\n     * to get comma-separated values (`key=a,b,c`).\n     *\n     * Null / undefined values are silently skipped.\n     */\n    add(key: string, value: unknown, options?: { style?: \"comma\" }): this {\n        if (value === undefined || value === null) {\n            return this;\n        }\n        const serialized = toQueryString(\n            { [key]: value },\n            { arrayFormat: options?.style === \"comma\" ? \"comma\" : \"repeat\" },\n        );\n        if (serialized.length > 0) {\n            this.parts.set(key, serialized);\n        }\n        return this;\n    }\n\n    /**\n     * Adds multiple query parameters at once from a record.\n     * All parameters use the default \"repeat\" array format.\n     * Null / undefined values are silently skipped.\n     */\n    addMany(params: Record<string, unknown>): this {\n        if (params != null) {\n            for (const [key, value] of Object.entries(params)) {\n                this.add(key, value);\n            }\n        }\n        return this;\n    }\n\n    /**\n     * Merges additional query parameters supplied at call-time via\n     * `requestOptions.queryParams`. Overrides existing keys (last-write-wins).\n     */\n    mergeAdditional(additionalParams?: Record<string, unknown>): this {\n        if (additionalParams != null) {\n            for (const [key, value] of Object.entries(additionalParams)) {\n                if (value === undefined || value === null) {\n                    continue;\n                }\n                const serialized = toQueryString({ [key]: value }, { arrayFormat: \"repeat\" });\n                if (serialized.length > 0) {\n                    this.parts.set(key, serialized);\n                }\n            }\n        }\n        return this;\n    }\n\n    /**\n     * Returns the assembled query string (without the leading `?`).\n     * Returns an empty string when no parameters were added.\n     */\n    build(): string {\n        return [...this.parts.values()].join(\"&\");\n    }\n}\n"]}

package/dist/core/url/encodePathParam.d.ts

@@ -0,0 +1,2 @@
+export declare function encodePathParam(param: unknown): string;
+//# sourceMappingURL=encodePathParam.d.ts.map

package/dist/core/url/encodePathParam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodePathParam.d.ts","sourceRoot":"","sources":["../../../core/url/encodePathParam.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBtD"}

package/dist/core/url/encodePathParam.js

@@ -0,0 +1,19 @@
+export function encodePathParam(param) {
+    if (param === null) {
+        return "null";
+    }
+    const typeofParam = typeof param;
+    switch (typeofParam) {
+        case "undefined":
+            return "undefined";
+        case "string":
+        case "number":
+        case "boolean":
+            break;
+        default:
+            param = String(param);
+            break;
+    }
+    return encodeURIComponent(param);
+}
+//# sourceMappingURL=encodePathParam.js.map

package/dist/core/url/encodePathParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodePathParam.js","sourceRoot":"","sources":["../../../core/url/encodePathParam.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC;IACjC,QAAQ,WAAW,EAAE,CAAC;QAClB,KAAK,WAAW;YACZ,OAAO,WAAW,CAAC;QACvB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACV,MAAM;QACV;YACI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,MAAM;IACd,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAkC,CAAC,CAAC;AAClE,CAAC","sourcesContent":["export function encodePathParam(param: unknown): string {\n    if (param === null) {\n        return \"null\";\n    }\n    const typeofParam = typeof param;\n    switch (typeofParam) {\n        case \"undefined\":\n            return \"undefined\";\n        case \"string\":\n        case \"number\":\n        case \"boolean\":\n            break;\n        default:\n            param = String(param);\n            break;\n    }\n    return encodeURIComponent(param as string | number | boolean);\n}\n"]}

package/dist/core/url/index.d.ts

@@ -0,0 +1,5 @@
+export { encodePathParam } from "./encodePathParam.js";
+export { join } from "./join.js";
+export { queryBuilder } from "./QueryStringBuilder.js";
+export { toQueryString } from "./qs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/url/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/url/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/core/url/index.js

@@ -0,0 +1,5 @@
+export { encodePathParam } from "./encodePathParam.js";
+export { join } from "./join.js";
+export { queryBuilder } from "./QueryStringBuilder.js";
+export { toQueryString } from "./qs.js";
+//# sourceMappingURL=index.js.map

package/dist/core/url/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/url/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC","sourcesContent":["export { encodePathParam } from \"./encodePathParam.js\";\nexport { join } from \"./join.js\";\nexport { queryBuilder } from \"./QueryStringBuilder.js\";\nexport { toQueryString } from \"./qs.js\";\n"]}

package/dist/core/url/join.d.ts

@@ -0,0 +1,2 @@
+export declare function join(base: string, ...segments: string[]): string;
+//# sourceMappingURL=join.d.ts.map

package/dist/core/url/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../core/url/join.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAmChE"}

package/dist/core/url/join.js

@@ -0,0 +1,66 @@
+export function join(base, ...segments) {
+    if (!base) {
+        return "";
+    }
+    if (segments.length === 0) {
+        return base;
+    }
+    if (base.includes("://")) {
+        let url;
+        try {
+            url = new URL(base);
+        }
+        catch {
+            return joinPath(base, ...segments);
+        }
+        const lastSegment = segments[segments.length - 1];
+        const shouldPreserveTrailingSlash = lastSegment?.endsWith("/");
+        for (const segment of segments) {
+            const cleanSegment = trimSlashes(segment);
+            if (cleanSegment) {
+                url.pathname = joinPathSegments(url.pathname, cleanSegment);
+            }
+        }
+        if (shouldPreserveTrailingSlash && !url.pathname.endsWith("/")) {
+            url.pathname += "/";
+        }
+        return url.toString();
+    }
+    return joinPath(base, ...segments);
+}
+function joinPath(base, ...segments) {
+    if (segments.length === 0) {
+        return base;
+    }
+    let result = base;
+    const lastSegment = segments[segments.length - 1];
+    const shouldPreserveTrailingSlash = lastSegment?.endsWith("/");
+    for (const segment of segments) {
+        const cleanSegment = trimSlashes(segment);
+        if (cleanSegment) {
+            result = joinPathSegments(result, cleanSegment);
+        }
+    }
+    if (shouldPreserveTrailingSlash && !result.endsWith("/")) {
+        result += "/";
+    }
+    return result;
+}
+function joinPathSegments(left, right) {
+    if (left.endsWith("/")) {
+        return left + right;
+    }
+    return `${left}/${right}`;
+}
+function trimSlashes(str) {
+    if (!str)
+        return str;
+    let start = 0;
+    let end = str.length;
+    if (str.startsWith("/"))
+        start = 1;
+    if (str.endsWith("/"))
+        end = str.length - 1;
+    return start === 0 && end === str.length ? str : str.slice(start, end);
+}
+//# sourceMappingURL=join.js.map

package/dist/core/url/join.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.js","sourceRoot":"","sources":["../../../core/url/join.ts"],"names":[],"mappings":"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","sourcesContent":["export function join(base: string, ...segments: string[]): string {\n    if (!base) {\n        return \"\";\n    }\n\n    if (segments.length === 0) {\n        return base;\n    }\n\n    if (base.includes(\"://\")) {\n        let url: URL;\n        try {\n            url = new URL(base);\n        } catch {\n            return joinPath(base, ...segments);\n        }\n\n        const lastSegment = segments[segments.length - 1];\n        const shouldPreserveTrailingSlash = lastSegment?.endsWith(\"/\");\n\n        for (const segment of segments) {\n            const cleanSegment = trimSlashes(segment);\n            if (cleanSegment) {\n                url.pathname = joinPathSegments(url.pathname, cleanSegment);\n            }\n        }\n\n        if (shouldPreserveTrailingSlash && !url.pathname.endsWith(\"/\")) {\n            url.pathname += \"/\";\n        }\n\n        return url.toString();\n    }\n\n    return joinPath(base, ...segments);\n}\n\nfunction joinPath(base: string, ...segments: string[]): string {\n    if (segments.length === 0) {\n        return base;\n    }\n\n    let result = base;\n\n    const lastSegment = segments[segments.length - 1];\n    const shouldPreserveTrailingSlash = lastSegment?.endsWith(\"/\");\n\n    for (const segment of segments) {\n        const cleanSegment = trimSlashes(segment);\n        if (cleanSegment) {\n            result = joinPathSegments(result, cleanSegment);\n        }\n    }\n\n    if (shouldPreserveTrailingSlash && !result.endsWith(\"/\")) {\n        result += \"/\";\n    }\n\n    return result;\n}\n\nfunction joinPathSegments(left: string, right: string): string {\n    if (left.endsWith(\"/\")) {\n        return left + right;\n    }\n    return `${left}/${right}`;\n}\n\nfunction trimSlashes(str: string): string {\n    if (!str) return str;\n\n    let start = 0;\n    let end = str.length;\n\n    if (str.startsWith(\"/\")) start = 1;\n    if (str.endsWith(\"/\")) end = str.length - 1;\n\n    return start === 0 && end === str.length ? str : str.slice(start, end);\n}\n"]}

package/dist/core/url/qs.d.ts

@@ -0,0 +1,8 @@
+type ArrayFormat = "indices" | "repeat" | "comma";
+interface QueryStringOptions {
+    arrayFormat?: ArrayFormat;
+    encode?: boolean;
+}
+export declare function toQueryString(obj: unknown, options?: QueryStringOptions): string;
+export {};
+//# sourceMappingURL=qs.d.ts.map

package/dist/core/url/qs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qs.d.ts","sourceRoot":"","sources":["../../../core/url/qs.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElD,UAAU,kBAAkB;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAuED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAUhF"}

package/dist/core/url/qs.js

@@ -0,0 +1,77 @@
+const defaultQsOptions = {
+    arrayFormat: "indices",
+    encode: true,
+};
+function encodeValue(value, shouldEncode) {
+    if (value === undefined) {
+        return "";
+    }
+    if (value === null) {
+        return "";
+    }
+    const stringValue = String(value);
+    return shouldEncode ? encodeURIComponent(stringValue) : stringValue;
+}
+function stringifyObject(obj, prefix = "", options) {
+    const parts = [];
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}[${key}]` : key;
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                continue;
+            }
+            const effectiveFormat = options.arrayFormat;
+            if (effectiveFormat === "comma") {
+                const encodedKey = options.encode ? encodeURIComponent(fullKey) : fullKey;
+                const encodedValues = value
+                    .filter((item) => item !== undefined && item !== null)
+                    .map((item) => encodeValue(item, options.encode));
+                if (encodedValues.length > 0) {
+                    parts.push(`${encodedKey}=${encodedValues.join(",")}`);
+                }
+            }
+            else {
+                for (let i = 0; i < value.length; i++) {
+                    const item = value[i];
+                    if (item === undefined) {
+                        continue;
+                    }
+                    if (typeof item === "object" && !Array.isArray(item) && item !== null) {
+                        const arrayKey = effectiveFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
+                        parts.push(...stringifyObject(item, arrayKey, options));
+                    }
+                    else {
+                        const arrayKey = effectiveFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
+                        const encodedKey = options.encode ? encodeURIComponent(arrayKey) : arrayKey;
+                        parts.push(`${encodedKey}=${encodeValue(item, options.encode)}`);
+                    }
+                }
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            if (Object.keys(value).length === 0) {
+                continue;
+            }
+            parts.push(...stringifyObject(value, fullKey, options));
+        }
+        else {
+            const encodedKey = options.encode ? encodeURIComponent(fullKey) : fullKey;
+            parts.push(`${encodedKey}=${encodeValue(value, options.encode)}`);
+        }
+    }
+    return parts;
+}
+export function toQueryString(obj, options) {
+    if (obj == null || typeof obj !== "object") {
+        return "";
+    }
+    const parts = stringifyObject(obj, "", {
+        ...defaultQsOptions,
+        ...options,
+    });
+    return parts.join("&");
+}
+//# sourceMappingURL=qs.js.map

package/dist/core/url/qs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qs.js","sourceRoot":"","sources":["../../../core/url/qs.ts"],"names":[],"mappings":"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","sourcesContent":["type ArrayFormat = \"indices\" | \"repeat\" | \"comma\";\n\ninterface QueryStringOptions {\n    arrayFormat?: ArrayFormat;\n    encode?: boolean;\n}\n\nconst defaultQsOptions: Required<QueryStringOptions> = {\n    arrayFormat: \"indices\",\n    encode: true,\n} as const;\n\nfunction encodeValue(value: unknown, shouldEncode: boolean): string {\n    if (value === undefined) {\n        return \"\";\n    }\n    if (value === null) {\n        return \"\";\n    }\n    const stringValue = String(value);\n    return shouldEncode ? encodeURIComponent(stringValue) : stringValue;\n}\n\nfunction stringifyObject(obj: Record<string, unknown>, prefix = \"\", options: Required<QueryStringOptions>): string[] {\n    const parts: string[] = [];\n\n    for (const [key, value] of Object.entries(obj)) {\n        const fullKey = prefix ? `${prefix}[${key}]` : key;\n\n        if (value === undefined) {\n            continue;\n        }\n\n        if (Array.isArray(value)) {\n            if (value.length === 0) {\n                continue;\n            }\n            const effectiveFormat = options.arrayFormat;\n            if (effectiveFormat === \"comma\") {\n                const encodedKey = options.encode ? encodeURIComponent(fullKey) : fullKey;\n                const encodedValues = value\n                    .filter((item) => item !== undefined && item !== null)\n                    .map((item) => encodeValue(item, options.encode));\n                if (encodedValues.length > 0) {\n                    parts.push(`${encodedKey}=${encodedValues.join(\",\")}`);\n                }\n            } else {\n                for (let i = 0; i < value.length; i++) {\n                    const item = value[i];\n                    if (item === undefined) {\n                        continue;\n                    }\n                    if (typeof item === \"object\" && !Array.isArray(item) && item !== null) {\n                        const arrayKey = effectiveFormat === \"indices\" ? `${fullKey}[${i}]` : fullKey;\n                        parts.push(...stringifyObject(item as Record<string, unknown>, arrayKey, options));\n                    } else {\n                        const arrayKey = effectiveFormat === \"indices\" ? `${fullKey}[${i}]` : fullKey;\n                        const encodedKey = options.encode ? encodeURIComponent(arrayKey) : arrayKey;\n                        parts.push(`${encodedKey}=${encodeValue(item, options.encode)}`);\n                    }\n                }\n            }\n        } else if (typeof value === \"object\" && value !== null) {\n            if (Object.keys(value as Record<string, unknown>).length === 0) {\n                continue;\n            }\n            parts.push(...stringifyObject(value as Record<string, unknown>, fullKey, options));\n        } else {\n            const encodedKey = options.encode ? encodeURIComponent(fullKey) : fullKey;\n            parts.push(`${encodedKey}=${encodeValue(value, options.encode)}`);\n        }\n    }\n\n    return parts;\n}\n\nexport function toQueryString(obj: unknown, options?: QueryStringOptions): string {\n    if (obj == null || typeof obj !== \"object\") {\n        return \"\";\n    }\n\n    const parts = stringifyObject(obj as Record<string, unknown>, \"\", {\n        ...defaultQsOptions,\n        ...options,\n    });\n    return parts.join(\"&\");\n}\n"]}

package/dist/crypto.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CryptoHelper — client-side signing utilities for the Spare SDK.
+ *
+ * Provides serializePayload() (canonical JSON) and signPayload() (ES256 detached JWS).
+ * Uses the Web Crypto API — no runtime dependencies, requires Node.js ≥ 18.
+ */
+export declare class CryptoHelper {
+    /**
+     * Serialize a request body to the canonical JSON string required for x-signature signing.
+     *
+     * Rules (must match server shared/utils/serialize-payload.ts exactly):
+     *   - Object keys sorted alphabetically, recursively
+     *   - null / undefined values omitted
+     *   - Top-level number primitives serialised with trailing zeros stripped after 5dp rounding
+     *     e.g. serializePayload(1000.00) → "1000", serializePayload(1000.5) → "1000.5"
+     *   - Numbers as object values remain as JSON numbers (standard JSON.stringify behaviour)
+     */
+    serializePayload(value: unknown): string;
+    /**
+     * Sign a request body using ES256 (ECDSA P-256). Returns a detached JWS string
+     * suitable for the x-signature header.
+     *
+     * @param privateKeyPem - PKCS8 PEM private key ("-----BEGIN PRIVATE KEY-----...")
+     * @param body - The request body object to sign (same object passed to the API call)
+     * @returns Detached JWS: "base64url(header)..base64url(signature)"
+     *
+     * @example
+     * ```ts
+     * const xSignature = await client.crypto.signPayload(privateKeyPem, requestBody);
+     * await client.paymentRequests.create({ ...requestBody, xSignature });
+     * ```
+     */
+    signPayload(privateKeyPem: string, body: unknown): Promise<string>;
+    private _toBase64Url;
+}
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,YAAY;IACvB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IA2BxC;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAiDxE,OAAO,CAAC,YAAY;CAMrB"}