@c9up/ream 0.1.3

package/dist/graphql/GraphQLEngine.js

@@ -0,0 +1,309 @@
+/**
+ * GraphQLEngine — schema-first GraphQL with Rust query validation.
+ *
+ * - Schema parsed from .graphql files at boot
+ * - Queries validated by Rust before NAPI crossing (when available)
+ * - Resolvers are IoC-injected controller-like classes
+ * - @Guard/@Role enforced per TOP-LEVEL resolver field (nested fields are
+ *   projected from the resolver's return value, not independently resolved —
+ *   so they carry no per-field guard; don't return guarded data from an
+ *   unguarded resolver and rely on a nested field guard to hide it).
+ * - The response is pruned to the client's selection set, so a resolver may
+ *   safely return a rich object (e.g. an ORM entity): fields the client did
+ *   not select are dropped before serialization.
+ * - Zero non-null assertions — types guaranteed by schema validation
+ *
+ * Usage:
+ *   const engine = new GraphQLEngine({ schemaPath: './app/graphql/schema.graphql' })
+ *   engine.resolver('Query', 'tasks', TaskResolver, 'tasks')
+ *   engine.resolver('Mutation', 'createTask', TaskResolver, 'createTask', { guard: 'jwt', role: 'cs_member' })
+ *
+ * @implements MISS-28
+ */
+import * as fs from 'node:fs';
+import { loadNapi } from '../helpers/napi-loader.js';
+let graphqlNativeCache;
+/**
+ * Lazily load the Rust GraphQL parser from the `index` NAPI binary. There is no
+ * TS fallback — when Rust exists, the engine is full-Rust. `loadNapi` throws a
+ * typed `ReamError` if the native module is missing.
+ */
+function graphqlNative() {
+    if (graphqlNativeCache === undefined) {
+        graphqlNativeCache = loadNapi({
+            binaryName: 'index',
+            callerMetaUrl: import.meta.url,
+            errorCodePrefix: 'GRAPHQL',
+        });
+    }
+    return graphqlNativeCache;
+}
+const OPERATION_TYPE = {
+    query: 'Query',
+    mutation: 'Mutation',
+    subscription: 'Subscription',
+};
+/** Map a Rust `ParsedField` (sub_fields) onto the engine's `SelectionField` (selection). */
+function mapRustField(f) {
+    return {
+        name: f.name,
+        alias: f.alias ?? undefined,
+        args: f.args,
+        selection: f.sub_fields.map(mapRustField),
+    };
+}
+export class GraphQLEngine {
+    #schemaSource;
+    #resolvers = new Map();
+    #container;
+    path;
+    #playground;
+    constructor(config) {
+        if (!fs.existsSync(config.schemaPath)) {
+            throw new Error(`GraphQL schema not found: ${config.schemaPath}`);
+        }
+        this.#schemaSource = fs.readFileSync(config.schemaPath, 'utf8');
+        this.path = config.path ?? '/graphql';
+        this.#playground = config.playground ?? process.env.NODE_ENV !== 'production';
+    }
+    /** Set IoC container for resolver instantiation. */
+    useContainer(container) {
+        this.#container = container;
+    }
+    /** Register a resolver for a type.field. */
+    resolver(typeName, fieldName, handlerClass, methodName, options) {
+        const key = `${typeName}.${fieldName}`;
+        this.#resolvers.set(key, {
+            typeName,
+            fieldName,
+            handlerClass,
+            methodName,
+            options: options ?? {},
+        });
+    }
+    /** Handle a GraphQL HTTP request. */
+    async handle(ctx) {
+        const method = ctx.request.method();
+        // Playground
+        if (method === 'GET' && this.#playground) {
+            ctx.response.header('Content-Type', 'text/html');
+            ctx.response.status(200).send(this.#renderPlayground());
+            return;
+        }
+        if (method !== 'POST') {
+            ctx.response.status(405).json({ errors: [{ message: 'Method not allowed' }] });
+            return;
+        }
+        const rawBody = ctx.request.body();
+        const body = parseGraphQLBody(rawBody);
+        if (!body) {
+            ctx.response.status(400).json({ errors: [{ message: 'Missing or invalid query' }] });
+            return;
+        }
+        try {
+            const result = await this.#execute(body, ctx);
+            ctx.response.status(200).json(result);
+        }
+        catch (err) {
+            const message = process.env.NODE_ENV !== 'production' && err instanceof Error
+                ? err.message
+                : 'Internal server error';
+            ctx.response.status(500).json({ errors: [{ message }] });
+        }
+    }
+    /** Execute a GraphQL query against registered resolvers. */
+    async #execute(request, ctx) {
+        // Parse the query to extract operation type and fields
+        const parsed = this.#parseQuery(request.query);
+        if (parsed.errors) {
+            return { errors: parsed.errors };
+        }
+        const data = {};
+        const errors = [];
+        for (const field of parsed.fields) {
+            const outcome = await this.#resolveField(field, parsed.typeName, request, ctx);
+            if (outcome.ok) {
+                data[field.alias ?? field.name] = outcome.value;
+            }
+            else {
+                errors.push(outcome.error);
+            }
+        }
+        return {
+            data: Object.keys(data).length > 0 ? data : undefined,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    /** Resolve one selection field: lookup → guards → invoke → prune. */
+    async #resolveField(field, typeName, request, ctx) {
+        const key = `${typeName}.${field.name}`;
+        const entry = this.#resolvers.get(key);
+        if (!entry) {
+            return {
+                ok: false,
+                error: { message: `No resolver for ${key}`, path: [field.name] },
+            };
+        }
+        const guardError = this.#enforceGuards(entry.options, ctx);
+        if (guardError) {
+            return { ok: false, error: { message: guardError, path: [field.name] } };
+        }
+        try {
+            // Resolve handler via IoC or direct instantiation.
+            const instance = this.#container
+                ? this.#container.make(entry.handlerClass)
+                : new entry.handlerClass();
+            const handler = instance[entry.methodName];
+            if (typeof handler !== 'function') {
+                return {
+                    ok: false,
+                    error: {
+                        message: `Resolver method ${entry.methodName} not found`,
+                        path: [field.name],
+                    },
+                };
+            }
+            const args = this.#buildArgs(field, request.variables);
+            const result = await handler.call(instance, null, args, ctx);
+            // Prune to the client's selection set: a resolver returning a rich
+            // object (ORM entity, etc.) must not leak fields the client did not
+            // ask for. Empty selection (scalar field) returns the value as-is.
+            return { ok: true, value: pruneToSelection(result, field.selection) };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : 'Resolver error';
+            return { ok: false, error: { message: msg, path: [field.name] } };
+        }
+    }
+    /**
+     * Build the resolver argument bag: `$variable` references resolve against
+     * `request.variables`, then any unreferenced variables are merged in.
+     */
+    #buildArgs(field, variables) {
+        const args = {};
+        for (const [k, v] of Object.entries(field.args)) {
+            if (typeof v === 'string' && v.startsWith('$') && variables) {
+                args[k] = variables[v.slice(1)];
+            }
+            else {
+                args[k] = v;
+            }
+        }
+        if (variables) {
+            for (const [k, v] of Object.entries(variables)) {
+                if (!(k in args))
+                    args[k] = v;
+            }
+        }
+        return args;
+    }
+    /** Enforce guard/role/permission on a resolver. */
+    #enforceGuards(options, ctx) {
+        const guards = [...(options.guards ?? []), ...(options.guard ? [options.guard] : [])];
+        const roles = [...(options.roles ?? []), ...(options.role ? [options.role] : [])];
+        const permissions = options.permissions ?? [];
+        const needsAuth = guards.length > 0 || roles.length > 0 || permissions.length > 0;
+        if (needsAuth && !ctx.auth?.authenticated) {
+            return 'Unauthorized';
+        }
+        if (roles.length > 0) {
+            const userRoles = ctx.auth?.roles ?? [];
+            if (!roles.some((r) => userRoles.includes(r))) {
+                return 'Insufficient role';
+            }
+        }
+        if (permissions.length > 0) {
+            const userPerms = ctx.auth?.permissions ?? [];
+            if (!permissions.every((p) => userPerms.includes(p))) {
+                return 'Insufficient permissions';
+            }
+        }
+        return null;
+    }
+    /**
+     * Parse a GraphQL query via the Rust `ream-graphql` crate (operation type +
+     * fields with arguments). Spec-compliant; invalid queries return errors.
+     */
+    #parseQuery(query) {
+        // Full-Rust: the spec-compliant `ream-graphql` parser (graphql-parser
+        // crate) rejects invalid queries before any resolver runs. No TS fallback —
+        // ream ships the native binary, so when Rust exists the engine is Rust.
+        const raw = JSON.parse(graphqlNative().graphqlParse(query));
+        const typeName = OPERATION_TYPE[raw.operation_type] ?? 'Query';
+        if (raw.errors.length > 0) {
+            return { typeName, fields: [], errors: raw.errors.map((message) => ({ message })) };
+        }
+        return { typeName, fields: raw.fields.map(mapRustField) };
+    }
+    #renderPlayground() {
+        return `<!DOCTYPE html>
+<html>
+<head>
+  <title>GraphQL Playground</title>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/graphiql@3/graphiql.min.css" />
+</head>
+<body style="margin:0;overflow:hidden">
+  <div id="graphiql" style="height:100vh"></div>
+  <script crossorigin src="https://cdn.jsdelivr.net/npm/react@18/umd/react.production.min.js"></script>
+  <script crossorigin src="https://cdn.jsdelivr.net/npm/react-dom@18/umd/react-dom.production.min.js"></script>
+  <script crossorigin src="https://cdn.jsdelivr.net/npm/graphiql@3/graphiql.min.js"></script>
+  <script>
+    const root = ReactDOM.createRoot(document.getElementById('graphiql'));
+    root.render(React.createElement(GraphiQL, {
+      fetcher: GraphiQL.createFetcher({ url: ${JSON.stringify(this.path)} }),
+    }));
+  </script>
+</body>
+</html>`;
+    }
+    /** Get the raw schema source for introspection. */
+    getSchemaSource() {
+        return this.#schemaSource;
+    }
+}
+/** Parse and validate an unknown request body as a GraphQL request object. */
+function parseGraphQLBody(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        return null;
+    // After typeof check, body is a non-null non-array object; index via 'in' narrowing
+    const q = 'query' in body ? body.query : undefined;
+    if (typeof q !== 'string')
+        return null;
+    let variables;
+    if ('variables' in body &&
+        body.variables !== null &&
+        typeof body.variables === 'object' &&
+        !Array.isArray(body.variables)) {
+        // biome-ignore lint/suspicious/noExplicitAny: narrowed to non-null non-array object above; branded as Record for safe spreading
+        variables = body.variables;
+    }
+    const rawOpName = 'operationName' in body ? body.operationName : undefined;
+    const operationName = typeof rawOpName === 'string' ? rawOpName : undefined;
+    return { query: q, variables, operationName };
+}
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/**
+ * Project a resolver result onto the client's selection set. A field with an
+ * empty selection (a scalar leaf) is returned untouched; an object is reduced
+ * to only the selected keys (recursing into nested selections); an array maps
+ * the projection over its items. This is what stops a resolver that returns a
+ * rich object (ORM entity, etc.) from leaking unselected fields.
+ */
+export function pruneToSelection(value, selection) {
+    if (selection.length === 0)
+        return value;
+    if (Array.isArray(value))
+        return value.map((v) => pruneToSelection(v, selection));
+    if (!isRecord(value))
+        return value;
+    const out = {};
+    for (const field of selection) {
+        if (field.name in value) {
+            out[field.alias ?? field.name] = pruneToSelection(value[field.name], field.selection);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=GraphQLEngine.js.map

package/dist/graphql/GraphQLEngine.js.map

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

package/dist/graphql/GraphQLProvider.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `GraphQLProvider` — wires the GraphQL gateway into the Ream pipeline.
+ *
+ * Opt-in: does nothing unless `config.graphql.schemaPath` is set (or an engine
+ * is injected for tests). When configured:
+ *   - `register()` — construct a `GraphQLEngine` from `config.graphql`, give it
+ *     the IoC container for resolver DI, and bind it under the `'graphql'` token:
+ *
+ *       const gql = app.container.make<GraphQLEngine>('graphql')
+ *       gql.resolver('Query', 'tasks', TaskResolver, 'tasks')
+ *
+ *   - `boot()` — mount the engine at `engine.path` (default `/graphql`) for both
+ *     GET (playground/introspection) and POST (queries).
+ *
+ * @implements Story 24.5
+ */
+import type { AppContext } from '../Provider.js';
+import { Provider } from '../Provider.js';
+import { GraphQLEngine } from './GraphQLEngine.js';
+export interface GraphQLProviderOptions {
+    /** Override the `GraphQLEngine` instance — used by tests. */
+    engine?: GraphQLEngine;
+}
+export declare class GraphQLProvider extends Provider {
+    #private;
+    constructor(app: AppContext, options?: GraphQLProviderOptions);
+    /** The wired engine, or undefined when GraphQL is not configured. */
+    get engine(): GraphQLEngine | undefined;
+    register(): void;
+    boot(): Promise<void>;
+}
+//# sourceMappingURL=GraphQLProvider.d.ts.map

package/dist/graphql/GraphQLProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphQLProvider.d.ts","sourceRoot":"","sources":["../../src/graphql/GraphQLProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAsB,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEtE,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED,qBAAa,eAAgB,SAAQ,QAAQ;;gBAG/B,GAAG,EAAE,UAAU,EAAE,OAAO,GAAE,sBAA2B;IAKjE,qEAAqE;IACrE,IAAI,MAAM,IAAI,aAAa,GAAG,SAAS,CAEtC;IAEQ,QAAQ,IAAI,IAAI;IASV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CASrC"}

package/dist/graphql/GraphQLProvider.js

@@ -0,0 +1,49 @@
+/**
+ * `GraphQLProvider` — wires the GraphQL gateway into the Ream pipeline.
+ *
+ * Opt-in: does nothing unless `config.graphql.schemaPath` is set (or an engine
+ * is injected for tests). When configured:
+ *   - `register()` — construct a `GraphQLEngine` from `config.graphql`, give it
+ *     the IoC container for resolver DI, and bind it under the `'graphql'` token:
+ *
+ *       const gql = app.container.make<GraphQLEngine>('graphql')
+ *       gql.resolver('Query', 'tasks', TaskResolver, 'tasks')
+ *
+ *   - `boot()` — mount the engine at `engine.path` (default `/graphql`) for both
+ *     GET (playground/introspection) and POST (queries).
+ *
+ * @implements Story 24.5
+ */
+import { Provider } from '../Provider.js';
+import { GraphQLEngine } from './GraphQLEngine.js';
+export class GraphQLProvider extends Provider {
+    #engine;
+    constructor(app, options = {}) {
+        super(app);
+        this.#engine = options.engine;
+    }
+    /** The wired engine, or undefined when GraphQL is not configured. */
+    get engine() {
+        return this.#engine;
+    }
+    register() {
+        const config = this.app.config.get('graphql');
+        const engine = this.#engine ?? (config?.schemaPath ? new GraphQLEngine(config) : undefined);
+        if (!engine)
+            return; // GraphQL not configured — opt-out.
+        engine.useContainer(this.app.container);
+        this.#engine = engine;
+        this.app.container.singleton('graphql', () => engine);
+    }
+    async boot() {
+        const engine = this.#engine;
+        if (!engine)
+            return;
+        const router = this.app.container.make('router');
+        // GraphQLEngine.handle() serves the playground on GET and executes queries
+        // on POST, so mount the same path for both verbs.
+        router.get(engine.path, (ctx) => engine.handle(ctx));
+        router.post(engine.path, (ctx) => engine.handle(ctx));
+    }
+}
+//# sourceMappingURL=GraphQLProvider.js.map

package/dist/graphql/GraphQLProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphQLProvider.js","sourceRoot":"","sources":["../../src/graphql/GraphQLProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAsB,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOtE,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,OAAO,CAAgB;IAEvB,YAAY,GAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAA;IAC/B,CAAC;IAED,qEAAqE;IACrE,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAEQ,QAAQ;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAgB,SAAS,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAC3F,IAAI,CAAC,MAAM;YAAE,OAAM,CAAC,oCAAoC;QACxD,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACvC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAA;IACvD,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAS,QAAQ,CAAC,CAAA;QACxD,2EAA2E;QAC3E,kDAAkD;QAClD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QACpD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IACvD,CAAC;CACF"}

package/dist/helpers/base64.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Encode a string or Buffer to standard base64.
+ *
+ * @example
+ * base64.encode('hello') // 'aGVsbG8='
+ */
+declare function encode(value: string | Buffer): string;
+/**
+ * Decode a standard base64 string. Returns null on invalid input unless strict mode,
+ * in which case it throws.
+ *
+ * @example
+ * base64.decode('aGVsbG8=') // 'hello'
+ * base64.decode('!!!') // null
+ */
+declare function decode(value: string, encoding?: BufferEncoding, strict?: boolean): string | null;
+/**
+ * Encode a string or Buffer to base64url (no padding, uses - and _ instead of + and /).
+ *
+ * @example
+ * base64.urlEncode('hello') // 'aGVsbG8'
+ */
+declare function urlEncode(value: string | Buffer): string;
+/**
+ * Decode a base64url string. Returns null on invalid input unless strict mode,
+ * in which case it throws.
+ *
+ * @example
+ * base64.urlDecode('aGVsbG8') // 'hello'
+ * base64.urlDecode('!!!') // null
+ */
+declare function urlDecode(value: string, encoding?: BufferEncoding, strict?: boolean): string | null;
+export declare const base64: {
+    encode: typeof encode;
+    decode: typeof decode;
+    urlEncode: typeof urlEncode;
+    urlDecode: typeof urlDecode;
+};
+export {};
+//# sourceMappingURL=base64.d.ts.map

package/dist/helpers/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/helpers/base64.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,iBAAS,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;;GAOG;AACH,iBAAS,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,EAAE,MAAM,UAAQ,GAAG,MAAM,GAAG,IAAI,CAWhG;AAED;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;;;GAOG;AACH,iBAAS,SAAS,CAChB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,cAAwB,EAClC,MAAM,UAAQ,GACb,MAAM,GAAG,IAAI,CAWf;AAED,eAAO,MAAM,MAAM;;;;;CAA2C,CAAA"}

package/dist/helpers/base64.js

@@ -0,0 +1,70 @@
+const STANDARD_B64_RE = /^[A-Za-z0-9+/]*={0,2}$/;
+const URL_B64_RE = /^[A-Za-z0-9_-]*$/;
+/**
+ * Encode a string or Buffer to standard base64.
+ *
+ * @example
+ * base64.encode('hello') // 'aGVsbG8='
+ */
+function encode(value) {
+    const buf = typeof value === 'string' ? Buffer.from(value, 'utf-8') : value;
+    return buf.toString('base64');
+}
+/**
+ * Decode a standard base64 string. Returns null on invalid input unless strict mode,
+ * in which case it throws.
+ *
+ * @example
+ * base64.decode('aGVsbG8=') // 'hello'
+ * base64.decode('!!!') // null
+ */
+function decode(value, encoding = 'utf-8', strict = false) {
+    if (!STANDARD_B64_RE.test(value)) {
+        if (strict)
+            throw new Error(`Invalid base64 string: ${value}`);
+        return null;
+    }
+    try {
+        return Buffer.from(value, 'base64').toString(encoding);
+    }
+    catch {
+        if (strict)
+            throw new Error(`Failed to decode base64 string: ${value}`);
+        return null;
+    }
+}
+/**
+ * Encode a string or Buffer to base64url (no padding, uses - and _ instead of + and /).
+ *
+ * @example
+ * base64.urlEncode('hello') // 'aGVsbG8'
+ */
+function urlEncode(value) {
+    const buf = typeof value === 'string' ? Buffer.from(value, 'utf-8') : value;
+    return buf.toString('base64url');
+}
+/**
+ * Decode a base64url string. Returns null on invalid input unless strict mode,
+ * in which case it throws.
+ *
+ * @example
+ * base64.urlDecode('aGVsbG8') // 'hello'
+ * base64.urlDecode('!!!') // null
+ */
+function urlDecode(value, encoding = 'utf-8', strict = false) {
+    if (!URL_B64_RE.test(value)) {
+        if (strict)
+            throw new Error(`Invalid base64url string: ${value}`);
+        return null;
+    }
+    try {
+        return Buffer.from(value, 'base64url').toString(encoding);
+    }
+    catch {
+        if (strict)
+            throw new Error(`Failed to decode base64url string: ${value}`);
+        return null;
+    }
+}
+export const base64 = { encode, decode, urlEncode, urlDecode };
+//# sourceMappingURL=base64.js.map

package/dist/helpers/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/helpers/base64.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,wBAAwB,CAAA;AAChD,MAAM,UAAU,GAAG,kBAAkB,CAAA;AAErC;;;;;GAKG;AACH,SAAS,MAAM,CAAC,KAAsB;IACpC,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC3E,OAAO,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,MAAM,CAAC,KAAa,EAAE,WAA2B,OAAO,EAAE,MAAM,GAAG,KAAK;IAC/E,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,IAAI,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAA;QACvE,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,KAAsB;IACvC,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC3E,OAAO,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAChB,KAAa,EACb,WAA2B,OAAO,EAClC,MAAM,GAAG,KAAK;IAEd,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,IAAI,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAA;QACjE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAA;QAC1E,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,7 @@
+export { base64 } from './base64.js';
+export type * from './is.js';
+export { default as is } from './is.js';
+export { safeEqual } from './safeEqual.js';
+export { default as string } from './string.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,mBAAmB,SAAS,CAAA;AAC5B,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAC/C,mBAAmB,YAAY,CAAA"}

package/dist/helpers/index.js

@@ -0,0 +1,5 @@
+export { base64 } from './base64.js';
+export { default as is } from './is.js';
+export { safeEqual } from './safeEqual.js';
+export { default as string } from './string.js';
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA"}

package/dist/helpers/is.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Returns true if value is a string.
+ * @example isString('hi') // true
+ */
+export declare function isString(v: unknown): v is string;
+/**
+ * Returns true if value is a finite number (excludes NaN).
+ * @example isNumber(42) // true; isNumber(NaN) // false
+ */
+export declare function isNumber(v: unknown): v is number;
+/**
+ * Returns true if value is a boolean.
+ * @example isBoolean(true) // true
+ */
+export declare function isBoolean(v: unknown): v is boolean;
+/**
+ * Returns true if value is a callable function.
+ * @example isFunction(() => {}) // true
+ */
+export declare function isFunction(v: unknown): v is (...args: unknown[]) => unknown;
+/**
+ * Returns true if value is a non-null object.
+ * @example isObject({}) // true; isObject(null) // false
+ */
+export declare function isObject(v: unknown): v is object;
+/**
+ * Returns true if value is a plain object (non-null, non-array, prototype is Object or null).
+ * @example isPlainObject({ a: 1 }) // true; isPlainObject([]) // false
+ */
+export declare function isPlainObject(v: unknown): v is Record<string, unknown>;
+/**
+ * Returns true if value is an array.
+ * @example isArray([1, 2]) // true
+ */
+export declare function isArray<T = unknown>(v: unknown): v is T[];
+/**
+ * Returns true if value has a thenable interface (is a Promise or promise-like).
+ * @example isPromise(Promise.resolve()) // true
+ */
+export declare function isPromise<T = unknown>(v: unknown): v is Promise<T>;
+/**
+ * Returns true if value is null.
+ * @example isNull(null) // true
+ */
+export declare function isNull(v: unknown): v is null;
+/**
+ * Returns true if value is undefined.
+ * @example isUndefined(undefined) // true
+ */
+export declare function isUndefined(v: unknown): v is undefined;
+/**
+ * Returns true if value is null or undefined.
+ * @example isNullOrUndefined(null) // true; isNullOrUndefined(undefined) // true
+ */
+export declare function isNullOrUndefined(v: unknown): v is null | undefined;
+/**
+ * Returns true if value is a Node.js Buffer.
+ * @example isBuffer(Buffer.from('hi')) // true
+ */
+export declare function isBuffer(v: unknown): v is Buffer;
+/**
+ * Returns true if value is a Date object.
+ * @example isDate(new Date()) // true
+ */
+export declare function isDate(v: unknown): v is Date;
+/**
+ * Returns true if value is a RegExp.
+ * @example isRegExp(/foo/) // true
+ */
+export declare function isRegExp(v: unknown): v is RegExp;
+/**
+ * Returns true if value is an Error instance.
+ * @example isError(new Error()) // true
+ */
+export declare function isError(v: unknown): v is Error;
+/**
+ * Returns true for null, undefined, empty string, empty array, empty plain object,
+ * empty Map, or empty Set.
+ * @example isEmpty('') // true; isEmpty([]) // true; isEmpty({}) // true
+ */
+export declare function isEmpty(v: unknown): boolean;
+declare const is: {
+    isString: typeof isString;
+    isNumber: typeof isNumber;
+    isBoolean: typeof isBoolean;
+    isFunction: typeof isFunction;
+    isObject: typeof isObject;
+    isPlainObject: typeof isPlainObject;
+    isArray: typeof isArray;
+    isPromise: typeof isPromise;
+    isNull: typeof isNull;
+    isUndefined: typeof isUndefined;
+    isNullOrUndefined: typeof isNullOrUndefined;
+    isBuffer: typeof isBuffer;
+    isDate: typeof isDate;
+    isRegExp: typeof isRegExp;
+    isError: typeof isError;
+    isEmpty: typeof isEmpty;
+};
+export default is;
+//# sourceMappingURL=is.d.ts.map