@glubean/sdk 0.2.0 → 0.2.2

package/dist/configure.d.ts

@@ -1,151 +1,3 @@
-/**
- * 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
- * import { configure } from "@glubean/sdk";
- * export const { vars, secrets, http } = configure({
- *   vars: { baseUrl: "BASE_URL" },
- *   http: { prefixUrl: "BASE_URL" },
- * });
- *
- * // tests/users.test.ts
- * import { test } from "@glubean/sdk";
- * import { http } from "./configure.js";
- *
- * export const listUsers = test("list-users", async (ctx) => {
- *   const res = await http.get("users").json();
- * });
- * ```
- *
- * @module configure
- */
-import type { ConfigureOptions, ConfigureResult, GlubeanAction, GlubeanEvent, GlubeanRuntime, Trace, HttpClient, PluginEntry, PluginFactory, ReservedConfigureKeys, ResolvePlugins } from "./types.js";
-/**
- * Shape of the runtime context injected by the harness before test execution.
- * This is the internal shape — the public `GlubeanRuntime` in types.ts adds
- * helper methods (requireVar, requireSecret, resolveTemplate) for plugins.
- *
- * @internal
- */
-export interface InternalRuntime {
-    vars: Record<string, string>;
-    secrets: Record<string, string>;
-    /** Session key-value store. Set during session setup, available to all tests. */
-    session: Record<string, unknown>;
-    http: HttpClient;
-    test?: GlubeanRuntime["test"];
-    trace?(t: Trace): void;
-    action?(a: GlubeanAction): void;
-    event?(ev: GlubeanEvent): void;
-    log?(message: string, data?: unknown): void;
-}
-/**
- * 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()`).
- *
- * This is used internally by `buildLazyHttp()` and exposed to plugin authors
- * via `GlubeanRuntime.resolveTemplate()`.
- */
-export declare function resolveTemplate(template: string, vars: Record<string, string>, secrets: Record<string, string>, session?: Record<string, unknown>): string;
-/**
- * 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.
- *
- * The returned objects can be shared across files via re-exports.
- *
- * @param options Configuration declaring vars, secrets, and HTTP defaults
- * @returns Lazy accessors for vars, secrets, and a pre-configured HTTP client
- *
- * @example Basic usage
- * ```ts
- * import { test, configure } from "@glubean/sdk";
- *
- * const { vars, http } = configure({
- *   vars: { baseUrl: "base_url" },
- *   http: { prefixUrl: "base_url" },
- * });
- *
- * export const listUsers = test("list-users", async (ctx) => {
- *   const res = await http.get("users").json();
- *   ctx.log(`Base URL: ${vars.baseUrl}`);
- * });
- * ```
- *
- * @example Full configuration with secrets
- * ```ts
- * const { vars, secrets, http } = configure({
- *   vars: { baseUrl: "base_url", orgId: "org_id" },
- *   secrets: { apiKey: "api_key" },
- *   http: {
- *     prefixUrl: "base_url",
- *     headers: { Authorization: "Bearer {{api_key}}" },
- *   },
- * });
- * ```
- *
- * @example Shared across test files
- * ```ts
- * // tests/configure.ts
- * export const { vars, secrets, http } = configure({ ... });
- *
- * // tests/users.test.ts
- * import { http, vars } from "./configure.js";
- * ```
- */
-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> | PluginEntry<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>;
+export { configure, resolveTemplate } from "./configure/index.js";
+export type { InternalRuntime } from "./configure/index.js";
 //# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,cAAc,EACd,KAAK,EACL,UAAU,EAGV,WAAW,EACX,aAAa,EAEb,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C;AA4GD;;;;;;;;;;;;;GAaG;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,CAgBR;AAyaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;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,EAEzD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CACtE,MAAM,EACN,KAAK,CACN,EAED,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,CACf;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,EAC1B;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,CAC3B,GACC,cAAc,CAAC,CAAC,CAAC,CAuBpB"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}