@glubean/sdk 0.2.1 → 0.2.3

package/dist/bootstrap-registry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Bootstrap attachment registry.
+ *
+ * Per contract-attachment-model.md v1.3:
+ *   - `contract.bootstrap(ref, spec)` registers an overlay targeting a
+ *     specific contract case (identified by testId = `${contractId}.${caseKey}`).
+ *   - Each test id may have at most one bootstrap overlay. Duplicate
+ *     registration throws.
+ *   - Registry is consulted by the runner at runnable resolution time
+ *     (single-case-execution-api §5.1 algorithm).
+ *
+ * The registry is a process-global side-effect map. Modules that export
+ * `contract.bootstrap(...)` register on evaluation. Scanner / runner are
+ * responsible for eager module loading per attachment model §7.4.
+ */
+import type { BootstrapAttachment, Bootstrap, ContractCaseRef } from "./contract-types.js";
+interface BootstrapRegistration {
+    testId: string;
+    contractId: string;
+    caseKey: string;
+    protocol: string;
+    spec: Bootstrap<unknown, unknown>;
+}
+/**
+ * Register a bootstrap overlay for a specific case. Called by
+ * `contract.bootstrap(ref, spec)`.
+ *
+ * Throws if another overlay is already registered for the same testId.
+ */
+export declare function registerBootstrap<Needs, Params = void>(ref: ContractCaseRef<Needs, unknown>, spec: Bootstrap<Params, Needs>): BootstrapAttachment<Needs, Params>;
+/** Look up a bootstrap registration by testId. Returns undefined if none. */
+export declare function getBootstrap(testId: string): BootstrapRegistration | undefined;
+/** Enumerate all registered bootstrap overlays. Used by scanner / CLI list. */
+export declare function listBootstraps(): BootstrapRegistration[];
+/** Test-only: clear the registry between test runs. Not part of public API. */
+export declare function clearBootstrapRegistry(): void;
+export {};
+//# sourceMappingURL=bootstrap-registry.d.ts.map

package/dist/bootstrap-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-registry.d.ts","sourceRoot":"","sources":["../src/bootstrap-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAE7B,UAAU,qBAAqB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;CACnC;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpD,GAAG,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,GAC7B,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAuBpC;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,GACb,qBAAqB,GAAG,SAAS,CAEnC;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,IAAI,qBAAqB,EAAE,CAExD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/bootstrap-registry.js

@@ -0,0 +1,54 @@
+/**
+ * Bootstrap attachment registry.
+ *
+ * Per contract-attachment-model.md v1.3:
+ *   - `contract.bootstrap(ref, spec)` registers an overlay targeting a
+ *     specific contract case (identified by testId = `${contractId}.${caseKey}`).
+ *   - Each test id may have at most one bootstrap overlay. Duplicate
+ *     registration throws.
+ *   - Registry is consulted by the runner at runnable resolution time
+ *     (single-case-execution-api §5.1 algorithm).
+ *
+ * The registry is a process-global side-effect map. Modules that export
+ * `contract.bootstrap(...)` register on evaluation. Scanner / runner are
+ * responsible for eager module loading per attachment model §7.4.
+ */
+const _bootstrapRegistry = new Map();
+/**
+ * Register a bootstrap overlay for a specific case. Called by
+ * `contract.bootstrap(ref, spec)`.
+ *
+ * Throws if another overlay is already registered for the same testId.
+ */
+export function registerBootstrap(ref, spec) {
+    const testId = `${ref.contractId}.${ref.caseKey}`;
+    if (_bootstrapRegistry.has(testId)) {
+        throw new Error(`contract.bootstrap: duplicate overlay for case "${testId}". ` +
+            `Only one bootstrap overlay per case is allowed. ` +
+            `If you need multiple variants, use the \`bootstrap.params\` schema.`);
+    }
+    _bootstrapRegistry.set(testId, {
+        testId,
+        contractId: ref.contractId,
+        caseKey: ref.caseKey,
+        protocol: ref.protocol,
+        spec: spec,
+    });
+    return {
+        __glubean_type: "bootstrap-attachment",
+        testId,
+    };
+}
+/** Look up a bootstrap registration by testId. Returns undefined if none. */
+export function getBootstrap(testId) {
+    return _bootstrapRegistry.get(testId);
+}
+/** Enumerate all registered bootstrap overlays. Used by scanner / CLI list. */
+export function listBootstraps() {
+    return [..._bootstrapRegistry.values()];
+}
+/** Test-only: clear the registry between test runs. Not part of public API. */
+export function clearBootstrapRegistry() {
+    _bootstrapRegistry.clear();
+}
+//# sourceMappingURL=bootstrap-registry.js.map

package/dist/bootstrap-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-registry.js","sourceRoot":"","sources":["../src/bootstrap-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAiC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAoC,EACpC,IAA8B;IAE9B,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;IAElD,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,mDAAmD,MAAM,KAAK;YAC5D,kDAAkD;YAClD,qEAAqE,CACxE,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE;QAC7B,MAAM;QACN,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,IAAI,EAAE,IAAmC;KAC1C,CAAC,CAAC;IAEH,OAAO;QACL,cAAc,EAAE,sBAAsB;QACtC,MAAM;KAC+B,CAAC;AAC1C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAC1B,MAAc;IAEd,OAAO,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB;IACpC,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/configure/http.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @module configure/http
+ *
+ * Lazy HTTP client builders for configure().
+ *
+ * - `buildLazyHttp` — creates a proxy that resolves and caches an extended
+ *   HttpClient on first call (WeakMap keyed by runtime identity).
+ * - `buildPassthroughHttp` — delegates directly to runtime.http when no
+ *   http options are declared in configure().
+ */
+import type { ConfigureHttpOptions, HttpClient } from "../types.js";
+/**
+ * Build a lazy HTTP client proxy.
+ * On first method call, resolves the config and creates an extended client.
+ * Result is cached per runtime identity via WeakMap.
+ * @internal
+ */
+export declare function buildLazyHttp(httpOptions: ConfigureHttpOptions): HttpClient;
+/**
+ * Build a passthrough HTTP client that delegates directly to runtime.http.
+ * Used when configure() is called without http options.
+ * @internal
+ */
+export declare function buildPassthroughHttp(): HttpClient;
+//# sourceMappingURL=http.d.ts.map

package/dist/configure/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/configure/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIpE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,oBAAoB,GAAG,UAAU,CA0E3E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAcjD"}

package/dist/configure/http.js

@@ -0,0 +1,88 @@
+/**
+ * @module configure/http
+ *
+ * Lazy HTTP client builders for configure().
+ *
+ * - `buildLazyHttp` — creates a proxy that resolves and caches an extended
+ *   HttpClient on first call (WeakMap keyed by runtime identity).
+ * - `buildPassthroughHttp` — delegates directly to runtime.http when no
+ *   http options are declared in configure().
+ */
+import { getRuntime } from "./runtime.js";
+import { resolveTemplate } from "./template.js";
+/**
+ * Build a lazy HTTP client proxy.
+ * On first method call, resolves the config and creates an extended client.
+ * Result is cached per runtime identity via WeakMap.
+ * @internal
+ */
+export function buildLazyHttp(httpOptions) {
+    const cache = new WeakMap();
+    function getClient() {
+        const runtime = getRuntime();
+        let client = cache.get(runtime);
+        if (client)
+            return client;
+        const extendOptions = {};
+        if (httpOptions.prefixUrl) {
+            extendOptions.prefixUrl = resolveTemplate(httpOptions.prefixUrl, runtime.vars, runtime.secrets, runtime.session);
+        }
+        if (httpOptions.headers) {
+            const resolvedHeaders = {};
+            for (const [name, template] of Object.entries(httpOptions.headers)) {
+                resolvedHeaders[name] = resolveTemplate(template, runtime.vars, runtime.secrets, runtime.session);
+            }
+            extendOptions.headers = resolvedHeaders;
+        }
+        if (httpOptions.searchParams) {
+            const resolvedParams = {};
+            for (const [name, template] of Object.entries(httpOptions.searchParams)) {
+                resolvedParams[name] = resolveTemplate(template, runtime.vars, runtime.secrets, runtime.session);
+            }
+            extendOptions.searchParams = resolvedParams;
+        }
+        if (httpOptions.timeout !== undefined)
+            extendOptions.timeout = httpOptions.timeout;
+        if (httpOptions.retry !== undefined)
+            extendOptions.retry = httpOptions.retry;
+        if (httpOptions.throwHttpErrors !== undefined)
+            extendOptions.throwHttpErrors = httpOptions.throwHttpErrors;
+        if (httpOptions.hooks)
+            extendOptions.hooks = httpOptions.hooks;
+        if (httpOptions.redirect !== undefined)
+            extendOptions.redirect = httpOptions.redirect;
+        if (typeof process !== "undefined" && process.env?.["GLUBEAN_DEBUG"]) {
+            process.stderr.write(`[glubean:debug] configure.getClient extendOptions=${JSON.stringify({ ...extendOptions, headers: "..." })}\n`);
+        }
+        client = runtime.http.extend(extendOptions);
+        cache.set(runtime, client);
+        return client;
+    }
+    const HTTP_METHODS = ["get", "post", "put", "patch", "delete", "head"];
+    const proxy = function (url, options) {
+        return getClient()(url, options);
+    };
+    for (const method of HTTP_METHODS) {
+        proxy[method] = (url, options) => getClient()[method](url, options);
+    }
+    proxy.extend = (options) => getClient().extend(options);
+    proxy._configuredTimeout = httpOptions.timeout;
+    return proxy;
+}
+/**
+ * Build a passthrough HTTP client that delegates directly to runtime.http.
+ * Used when configure() is called without http options.
+ * @internal
+ */
+export function buildPassthroughHttp() {
+    const HTTP_METHODS = ["get", "post", "put", "patch", "delete", "head"];
+    const proxy = function (url, options) {
+        return getRuntime().http(url, options);
+    };
+    for (const method of HTTP_METHODS) {
+        proxy[method] = (url, options) => getRuntime().http[method](url, options);
+    }
+    proxy.extend = (options) => getRuntime().http.extend(options);
+    return proxy;
+}
+//# sourceMappingURL=http.js.map

package/dist/configure/http.js.map

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

package/dist/configure/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @module configure
+ *
+ * File-level configuration for Glubean tests.
+ *
+ * `configure()` lets you declare shared dependencies (vars, secrets, HTTP config)
+ * once at the top of a test file (or in a shared `configure.ts`), eliminating
+ * repetitive `ctx.vars.require()` / `ctx.secrets.require()` calls in every test.
+ *
+ * All returned values are **lazy** — they are not resolved until a test function
+ * actually accesses them at runtime. This means:
+ * - Safe to call at module top-level (scanner won't trigger resolution)
+ * - Safe to share across files via re-exports
+ * - Each test execution gets the correct runtime values
+ *
+ * @example Single file usage
+ * ```ts
+ * import { test, configure } from "@glubean/sdk";
+ *
+ * const { vars, secrets, http } = configure({
+ *   vars: { baseUrl: "{{BASE_URL}}" },
+ *   secrets: { apiKey: "{{API_KEY}}" },
+ *   http: {
+ *     prefixUrl: "{{BASE_URL}}",
+ *     headers: { Authorization: "Bearer {{API_KEY}}" },
+ *   },
+ * });
+ *
+ * export const listUsers = test("list-users", async (ctx) => {
+ *   const res = await http.get("users").json();
+ *   ctx.assert(res.length > 0, "has users");
+ * });
+ * ```
+ *
+ * @example Shared across files (tests/configure.ts)
+ * ```ts
+ * // tests/configure.ts
+ * export const { vars, http } = configure({
+ *   vars: { baseUrl: "{{BASE_URL}}" },
+ *   http: { prefixUrl: "{{BASE_URL}}" },
+ * });
+ *
+ * // tests/users.test.ts
+ * import { http } from "./configure.js";
+ * export const listUsers = test("list-users", async (ctx) => {
+ *   const res = await http.get("users").json();
+ * });
+ * ```
+ */
+import type { ConfigureOptions, ConfigureResult, PluginFactory, ReservedConfigureKeys, ResolvePlugins } from "../types.js";
+export type { InternalRuntime } from "./runtime.js";
+export { resolveTemplate } from "./template.js";
+/**
+ * Declare file-level dependencies on vars, secrets, and HTTP configuration.
+ *
+ * Returns lazy accessors that resolve at test runtime, not at import time.
+ * All declared vars and secrets are **required** — missing values cause the test
+ * to fail immediately with a clear error message.
+ *
+ * @param options Configuration declaring vars, secrets, and HTTP defaults
+ * @returns Lazy accessors for vars, secrets, and a pre-configured HTTP client
+ */
+export declare function configure<V extends Record<string, string> = Record<string, string>, S extends Record<string, string> = Record<string, string>, P extends Record<string, PluginFactory<any>> = Record<string, never>>(options: ConfigureOptions & {
+    vars?: {
+        [K in keyof V]: string;
+    };
+    secrets?: {
+        [K in keyof S]: string;
+    };
+    plugins?: P & {
+        [K in ReservedConfigureKeys]?: never;
+    };
+}): ConfigureResult<{
+    [K in keyof V]: string;
+}, {
+    [K in keyof S]: string;
+}> & ResolvePlugins<P>;
+//# sourceMappingURL=index.d.ts.map

package/dist/configure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,cAAc,EACf,MAAM,aAAa,CAAC;AAKrB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEpE,OAAO,EAAE,gBAAgB,GAAG;IAC1B,IAAI,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;KAAE,CAAC;IAClC,OAAO,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;KAAE,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,GAAG;SAAG,CAAC,IAAI,qBAAqB,CAAC,CAAC,EAAE,KAAK;KAAE,CAAC;CACxD,GAEC,eAAe,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC,GACvE,cAAc,CAAC,CAAC,CAAC,CAoBpB"}

package/dist/configure/index.js

@@ -0,0 +1,78 @@
+/**
+ * @module configure
+ *
+ * File-level configuration for Glubean tests.
+ *
+ * `configure()` lets you declare shared dependencies (vars, secrets, HTTP config)
+ * once at the top of a test file (or in a shared `configure.ts`), eliminating
+ * repetitive `ctx.vars.require()` / `ctx.secrets.require()` calls in every test.
+ *
+ * All returned values are **lazy** — they are not resolved until a test function
+ * actually accesses them at runtime. This means:
+ * - Safe to call at module top-level (scanner won't trigger resolution)
+ * - Safe to share across files via re-exports
+ * - Each test execution gets the correct runtime values
+ *
+ * @example Single file usage
+ * ```ts
+ * import { test, configure } from "@glubean/sdk";
+ *
+ * const { vars, secrets, http } = configure({
+ *   vars: { baseUrl: "{{BASE_URL}}" },
+ *   secrets: { apiKey: "{{API_KEY}}" },
+ *   http: {
+ *     prefixUrl: "{{BASE_URL}}",
+ *     headers: { Authorization: "Bearer {{API_KEY}}" },
+ *   },
+ * });
+ *
+ * export const listUsers = test("list-users", async (ctx) => {
+ *   const res = await http.get("users").json();
+ *   ctx.assert(res.length > 0, "has users");
+ * });
+ * ```
+ *
+ * @example Shared across files (tests/configure.ts)
+ * ```ts
+ * // tests/configure.ts
+ * export const { vars, http } = configure({
+ *   vars: { baseUrl: "{{BASE_URL}}" },
+ *   http: { prefixUrl: "{{BASE_URL}}" },
+ * });
+ *
+ * // tests/users.test.ts
+ * import { http } from "./configure.js";
+ * export const listUsers = test("list-users", async (ctx) => {
+ *   const res = await http.get("users").json();
+ * });
+ * ```
+ */
+import { buildLazyVars, buildLazySecrets } from "./vars.js";
+import { buildLazyHttp, buildPassthroughHttp } from "./http.js";
+import { buildLazyPlugins } from "./plugin.js";
+export { resolveTemplate } from "./template.js";
+/**
+ * Declare file-level dependencies on vars, secrets, and HTTP configuration.
+ *
+ * Returns lazy accessors that resolve at test runtime, not at import time.
+ * All declared vars and secrets are **required** — missing values cause the test
+ * to fail immediately with a clear error message.
+ *
+ * @param options Configuration declaring vars, secrets, and HTTP defaults
+ * @returns Lazy accessors for vars, secrets, and a pre-configured HTTP client
+ */
+export function configure(options) {
+    const vars = options.vars
+        ? buildLazyVars(options.vars)
+        : {};
+    const secrets = options.secrets
+        ? buildLazySecrets(options.secrets)
+        : {};
+    const http = options.http ? buildLazyHttp(options.http) : buildPassthroughHttp();
+    const base = { vars, secrets, http };
+    if (options.plugins) {
+        Object.assign(base, buildLazyPlugins(options.plugins));
+    }
+    return base;
+}
+//# sourceMappingURL=index.js.map

package/dist/configure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AASH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAKvB,OAIC;IAID,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI;QACvB,CAAC,CAAC,aAAa,CAA6B,OAAO,CAAC,IAAI,CAAC;QACzD,CAAC,CAAE,EAA2C,CAAC;IAEjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO;QAC7B,CAAC,CAAC,gBAAgB,CAA6B,OAAO,CAAC,OAAO,CAAC;QAC/D,CAAC,CAAE,EAA2C,CAAC;IAEjD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAEjF,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAErC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,IAEc,CAAC;AACxB,CAAC"}

package/dist/configure/plugin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @module configure/plugin
+ *
+ * Lazy plugin builder for configure().
+ *
+ * Each plugin is a transparent Proxy at module load time. On first property
+ * access during test execution, the plugin factory is called with an augmented
+ * GlubeanRuntime. The instance is cached per runtime identity via WeakMap.
+ */
+import type { PluginFactory } from "../types.js";
+/** Reserved keys that plugins cannot shadow. */
+export declare const RESERVED_KEYS: Set<string>;
+/**
+ * Build a transparent Proxy that defers plugin instantiation until first use.
+ * @internal
+ */
+export declare function buildLazyPlugin(factory: PluginFactory<any>): unknown;
+/**
+ * Build lazy proxies for all declared plugins, checking for reserved key conflicts.
+ * @internal
+ */
+export declare function buildLazyPlugins(plugins: Record<string, PluginFactory<any>>): Record<string, unknown>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/configure/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/configure/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjE,gDAAgD;AAChD,eAAO,MAAM,aAAa,aAAuC,CAAC;AAkClE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAsBpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}

package/dist/configure/plugin.js

@@ -0,0 +1,81 @@
+/**
+ * @module configure/plugin
+ *
+ * Lazy plugin builder for configure().
+ *
+ * Each plugin is a transparent Proxy at module load time. On first property
+ * access during test execution, the plugin factory is called with an augmented
+ * GlubeanRuntime. The instance is cached per runtime identity via WeakMap.
+ */
+import { getRuntime, requireVar, requireSecret } from "./runtime.js";
+import { resolveTemplate } from "./template.js";
+/** Reserved keys that plugins cannot shadow. */
+export const RESERVED_KEYS = new Set(["vars", "secrets", "http"]);
+/**
+ * Resolve (or retrieve cached) the real plugin instance for the current runtime.
+ * @internal
+ */
+function resolvePlugin(factory, cache) {
+    const runtime = getRuntime();
+    if (cache.has(runtime))
+        return cache.get(runtime);
+    const noop = () => { };
+    const augmented = {
+        vars: runtime.vars,
+        secrets: runtime.secrets,
+        http: runtime.http,
+        test: runtime.test,
+        requireVar,
+        requireSecret,
+        resolveTemplate: (template) => resolveTemplate(template, runtime.vars, runtime.secrets, runtime.session),
+        trace: runtime.trace?.bind(runtime) ?? noop,
+        action: runtime.action?.bind(runtime) ?? noop,
+        event: runtime.event?.bind(runtime) ?? noop,
+        log: runtime.log?.bind(runtime) ?? noop,
+    };
+    const instance = factory.create(augmented);
+    cache.set(runtime, instance);
+    return instance;
+}
+/**
+ * Build a transparent Proxy that defers plugin instantiation until first use.
+ * @internal
+ */
+export function buildLazyPlugin(factory) {
+    const cache = new WeakMap();
+    return new Proxy(Object.create(null), {
+        get(_target, prop, receiver) {
+            const instance = resolvePlugin(factory, cache);
+            const value = Reflect.get(instance, prop, receiver);
+            return typeof value === "function" ? value.bind(instance) : value;
+        },
+        set(_target, prop, value) {
+            return Reflect.set(resolvePlugin(factory, cache), prop, value);
+        },
+        has(_target, prop) {
+            return Reflect.has(resolvePlugin(factory, cache), prop);
+        },
+        ownKeys() {
+            return Reflect.ownKeys(resolvePlugin(factory, cache));
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            return Object.getOwnPropertyDescriptor(resolvePlugin(factory, cache), prop);
+        },
+    });
+}
+/**
+ * Build lazy proxies for all declared plugins, checking for reserved key conflicts.
+ * @internal
+ */
+export function buildLazyPlugins(plugins) {
+    const result = {};
+    for (const [name, factory] of Object.entries(plugins)) {
+        if (RESERVED_KEYS.has(name)) {
+            throw new Error(`Plugin name "${name}" conflicts with a reserved configure() field. ` +
+                `Choose a different key (reserved: ${[...RESERVED_KEYS].join(", ")}).`);
+        }
+        result[name] = buildLazyPlugin(factory);
+    }
+    return result;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/configure/plugin.js.map

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

package/dist/configure/runtime.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module configure/runtime
+ *
+ * Runtime accessor helpers used by all configure lazy builders.
+ * Wraps the carrier's optional getRuntime() with a throw-on-missing contract.
+ */
+import { type InternalRuntime } from "../runtime-carrier.js";
+export type { InternalRuntime };
+/**
+ * Get the current runtime context, throwing if accessed outside test execution.
+ * @internal
+ */
+export declare function getRuntime(): InternalRuntime;
+/**
+ * Require a var from the runtime context. Throws if missing or empty.
+ * @internal
+ */
+export declare function requireVar(key: string): string;
+/**
+ * Require a secret from the runtime context. Throws if missing or empty.
+ * @internal
+ */
+export declare function requireSecret(key: string): string;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/configure/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAU5C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOjD"}

package/dist/configure/runtime.js

@@ -0,0 +1,45 @@
+/**
+ * @module configure/runtime
+ *
+ * Runtime accessor helpers used by all configure lazy builders.
+ * Wraps the carrier's optional getRuntime() with a throw-on-missing contract.
+ */
+import { getRuntime as getCarrierRuntime, } from "../runtime-carrier.js";
+/**
+ * Get the current runtime context, throwing if accessed outside test execution.
+ * @internal
+ */
+export function getRuntime() {
+    const runtime = getCarrierRuntime();
+    if (!runtime) {
+        throw new Error("configure() values can only be accessed during test execution. " +
+            "Did you try to read a var or secret at module load time? " +
+            "Move the access inside a test function.");
+    }
+    return runtime;
+}
+/**
+ * Require a var from the runtime context. Throws if missing or empty.
+ * @internal
+ */
+export function requireVar(key) {
+    const runtime = getRuntime();
+    const value = runtime.vars[key];
+    if (value === undefined || value === null || value === "") {
+        throw new Error(`Missing required var: ${key}`);
+    }
+    return value;
+}
+/**
+ * Require a secret from the runtime context. Throws if missing or empty.
+ * @internal
+ */
+export function requireSecret(key) {
+    const runtime = getRuntime();
+    const value = runtime.secrets[key];
+    if (value === undefined || value === null || value === "") {
+        throw new Error(`Missing required secret: ${key}`);
+    }
+    return value;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/configure/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/configure/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,IAAI,iBAAiB,GAEhC,MAAM,uBAAuB,CAAC;AAI/B;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,iEAAiE;YAC/D,2DAA2D;YAC3D,yCAAyC,CAC5C,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/configure/template.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module configure/template
+ *
+ * `{{key}}` placeholder resolution used by vars, secrets, and http builders.
+ *
+ * Resolution priority: session → secrets → vars.
+ */
+/** Regex for `{{key}}` template placeholders. */
+export declare const TEMPLATE_RE: RegExp;
+/**
+ * Resolve `{{key}}` template placeholders in a string.
+ *
+ * Resolution priority (first non-empty wins):
+ * 1. Session — dynamic values set during session setup (e.g., auth tokens)
+ * 2. Secrets — from `.env.secrets`
+ * 3. Vars — from `.env`
+ *
+ * Session values must be strings to resolve in templates. Non-string session
+ * values are silently skipped (they're still accessible via `ctx.session.get()`).
+ */
+export declare function resolveTemplate(template: string, vars: Record<string, string>, secrets: Record<string, string>, session?: Record<string, unknown>): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/configure/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/configure/template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iDAAiD;AACjD,eAAO,MAAM,WAAW,QAAsB,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAeR"}

package/dist/configure/template.js

@@ -0,0 +1,34 @@
+/**
+ * @module configure/template
+ *
+ * `{{key}}` placeholder resolution used by vars, secrets, and http builders.
+ *
+ * Resolution priority: session → secrets → vars.
+ */
+/** Regex for `{{key}}` template placeholders. */
+export const TEMPLATE_RE = /\{\{([\w-]+)\}\}/g;
+/**
+ * Resolve `{{key}}` template placeholders in a string.
+ *
+ * Resolution priority (first non-empty wins):
+ * 1. Session — dynamic values set during session setup (e.g., auth tokens)
+ * 2. Secrets — from `.env.secrets`
+ * 3. Vars — from `.env`
+ *
+ * Session values must be strings to resolve in templates. Non-string session
+ * values are silently skipped (they're still accessible via `ctx.session.get()`).
+ */
+export function resolveTemplate(template, vars, secrets, session) {
+    return template.replace(TEMPLATE_RE, (_match, key) => {
+        const sessionValue = session?.[key];
+        const value = (typeof sessionValue === "string" ? sessionValue : undefined) ??
+            secrets[key] ??
+            vars[key];
+        if (value === undefined || value === null || value === "") {
+            throw new Error(`Missing value for template placeholder "{{${key}}}" in configure() http headers. ` +
+                `Ensure "${key}" is available in session, as a secret, or as a var.`);
+        }
+        return value;
+    });
+}
+//# sourceMappingURL=template.js.map