@vibe-agent-toolkit/utils 0.2.0-rc.2 → 0.2.0-rc.4

package/dist/link-auth/template.js

@@ -1,89 +0,0 @@
-/**
- * Tiny template renderer for linkAuth rewrite + header templates.
- *
- * Syntax (strict, no escapes, no nesting):
- *   - `${name}`              → context[name]
- *   - `${transform(name)}`   → applyTransform(transform, context[name])
- *
- * Anything else inside `${...}` throws `TemplateSyntaxError`. Missing context
- * keys throw `TemplateMissingVarError`. Unknown transform names propagate
- * `UnknownTransformError` from the transforms allowlist.
- *
- * This is NOT the project's general-purpose Handlebars renderer
- * (`utils/template.ts`) — that one is `{{...}}` and consumed widely. linkAuth
- * needs different syntax and a closed transform set; the two coexist by
- * namespace (`link-auth/template.ts`).
- */
-import { applyTransform } from './transforms.js';
-const IDENTIFIER = /^[a-zA-Z_]\w*$/;
-const TRANSFORM_CALL = /^(?<fn>[a-zA-Z_]\w*)\((?<arg>[a-zA-Z_]\w*)\)$/;
-/**
- * Thrown when a template references a variable not present in the context.
- * Message names the missing variable and includes the full template for
- * caller-side debugging.
- */
-export class TemplateMissingVarError extends Error {
-    constructor(varName, template) {
-        super(`Template variable "${varName}" not in context. Template: ${template}`);
-        this.name = 'TemplateMissingVarError';
-    }
-}
-/**
- * Thrown when a template contains syntactically invalid content inside `${...}`
- * (empty expression, whitespace, unrecognized form) or an unterminated `${`.
- */
-export class TemplateSyntaxError extends Error {
-    constructor(detail, template) {
-        super(`Invalid template syntax — ${detail}. Template: ${template}`);
-        this.name = 'TemplateSyntaxError';
-    }
-}
-/**
- * Render a template by substituting `${...}` expressions from a context map.
- *
- * @throws {TemplateMissingVarError} if a referenced variable is absent
- * @throws {TemplateSyntaxError} for invalid expressions or unterminated `${`
- * @throws {UnknownTransformError} from a `${transform(name)}` call
- */
-export function renderTemplate(template, context) {
-    const rendered = template.replaceAll(/\$\{([^}]*)\}/g, (_match, body) => resolveExpression(body, template, context));
-    if (rendered.includes('${')) {
-        throw new TemplateSyntaxError('unterminated "${" with no matching "}"', template);
-    }
-    return rendered;
-}
-function resolveExpression(body, template, context) {
-    if (body !== body.trim()) {
-        throw new TemplateSyntaxError(`whitespace in "${body}"`, template);
-    }
-    if (IDENTIFIER.test(body)) {
-        return lookupContextVar(context, body, template);
-    }
-    const callMatch = TRANSFORM_CALL.exec(body);
-    if (callMatch?.groups !== undefined) {
-        const { fn, arg } = callMatch.groups;
-        if (fn === undefined || arg === undefined) {
-            throw new TemplateSyntaxError(`unexpected regex result for "${body}"`, template);
-        }
-        return applyTransform(fn, lookupContextVar(context, arg, template));
-    }
-    throw new TemplateSyntaxError(`unrecognized expression "${body}"`, template);
-}
-/**
- * Fetch a variable from the context map, blocking prototype-chain bypass.
- *
- * Without `Object.hasOwn`, `context["__proto__"]` would return `Object.prototype`
- * (a non-undefined object) and the renderer would substitute `[object Object]`
- * into the output. Mirrors the closed-allowlist discipline in `transforms.ts`.
- */
-function lookupContextVar(context, key, template) {
-    if (!Object.hasOwn(context, key)) {
-        throw new TemplateMissingVarError(key, template);
-    }
-    const value = context[key];
-    if (value === undefined) {
-        throw new TemplateMissingVarError(key, template);
-    }
-    return value;
-}
-//# sourceMappingURL=template.js.map

package/dist/link-auth/template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/link-auth/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,UAAU,GAAG,gBAAgB,CAAC;AACpC,MAAM,cAAc,GAAG,+CAA+C,CAAC;AAEvE;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CAAC,sBAAsB,OAAO,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,MAAc,EAAE,QAAgB;QAC1C,KAAK,CAAC,6BAA6B,MAAM,eAAe,QAAQ,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAA+B;IAC9E,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAC9E,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAC3C,CAAC;IAEF,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,wCAAwC,EAAE,QAAQ,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAY,EACZ,QAAgB,EAChB,OAA+B;IAE/B,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,IAAI,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC;QACrC,IAAI,EAAE,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,mBAAmB,CAAC,gCAAgC,IAAI,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,cAAc,CAAC,EAAE,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,IAAI,mBAAmB,CAAC,4BAA4B,IAAI,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CACvB,OAA+B,EAC/B,GAAW,EACX,QAAgB;IAEhB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,uBAAuB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,uBAAuB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/link-auth/transforms.d.ts

@@ -1,46 +0,0 @@
-/**
- * Transform allowlist for linkAuth rewrite templates.
- *
- * Rewrite `to:` templates may call transforms over named regex captures —
- * e.g. `${base64url(u)}` for Microsoft Graph share-ids. The allowed set is
- * frozen in this file: adding a transform requires a VAT PR (see issue #113
- * design §4.1). There is no arbitrary-evaluation path.
- *
- * v1 inputs are assumed to be ASCII URL host/path captures. Non-ASCII edge
- * cases (lone surrogates) are pinned by tests so future regressions surface.
- */
-declare const TRANSFORMS: {
-    readonly base64url: (s: string) => string;
-    readonly urlencode: (s: string) => string;
-    readonly lower: (s: string) => string;
-};
-export type TransformName = keyof typeof TRANSFORMS;
-/**
- * The closed allowlist of transform names. Callers parsing rewrite templates
- * can validate transform calls (e.g. `${base64url(u)}`) against this list at
- * config-load time, surfacing typos before any URL is rewritten.
- */
-export declare const ALLOWED_TRANSFORMS: readonly TransformName[];
-/**
- * Thrown by `applyTransform` when called with a name not in the closed
- * allowlist. The message names the bad transform and the full allowlist so
- * a misconfigured macro surfaces a clear error at load time.
- */
-export declare class UnknownTransformError extends Error {
-    constructor(name: string);
-}
-/**
- * Dispatch a transform by name on a string input.
- *
- * Security claim: only the names in `ALLOWED_TRANSFORMS` resolve; any other
- * input throws `UnknownTransformError`. Lookup uses `Object.hasOwn` to block
- * prototype-chain keys (`toString`, `__proto__`, `constructor`, …) that a
- * `name in TRANSFORMS` check would let through.
- *
- * @throws {UnknownTransformError} if `name` is not in the allowlist
- * @throws {URIError} from `urlencode` on lone-surrogate inputs — deliberate;
- *   v1 callers pass URL-derived captures that cannot legally contain these
- */
-export declare function applyTransform(name: string, input: string): string;
-export {};
-//# sourceMappingURL=transforms.d.ts.map

package/dist/link-auth/transforms.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/link-auth/transforms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,QAAA,MAAM,UAAU;4BACC,MAAM;4BACN,MAAM;wBACV,MAAM;CAC6B,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,UAAU,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,aAAa,EAEtD,CAAC;AAEF;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,IAAI,EAAE,MAAM;CAIzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlE"}

package/dist/link-auth/transforms.js

@@ -1,52 +0,0 @@
-/**
- * Transform allowlist for linkAuth rewrite templates.
- *
- * Rewrite `to:` templates may call transforms over named regex captures —
- * e.g. `${base64url(u)}` for Microsoft Graph share-ids. The allowed set is
- * frozen in this file: adding a transform requires a VAT PR (see issue #113
- * design §4.1). There is no arbitrary-evaluation path.
- *
- * v1 inputs are assumed to be ASCII URL host/path captures. Non-ASCII edge
- * cases (lone surrogates) are pinned by tests so future regressions surface.
- */
-const TRANSFORMS = {
-    base64url: (s) => Buffer.from(s, 'utf8').toString('base64url'),
-    urlencode: (s) => encodeURIComponent(s),
-    lower: (s) => s.toLowerCase(),
-};
-/**
- * The closed allowlist of transform names. Callers parsing rewrite templates
- * can validate transform calls (e.g. `${base64url(u)}`) against this list at
- * config-load time, surfacing typos before any URL is rewritten.
- */
-export const ALLOWED_TRANSFORMS = Object.freeze(Object.keys(TRANSFORMS));
-/**
- * Thrown by `applyTransform` when called with a name not in the closed
- * allowlist. The message names the bad transform and the full allowlist so
- * a misconfigured macro surfaces a clear error at load time.
- */
-export class UnknownTransformError extends Error {
-    constructor(name) {
-        super(`Unknown transform "${name}". Allowed: ${ALLOWED_TRANSFORMS.join(', ')}.`);
-        this.name = 'UnknownTransformError';
-    }
-}
-/**
- * Dispatch a transform by name on a string input.
- *
- * Security claim: only the names in `ALLOWED_TRANSFORMS` resolve; any other
- * input throws `UnknownTransformError`. Lookup uses `Object.hasOwn` to block
- * prototype-chain keys (`toString`, `__proto__`, `constructor`, …) that a
- * `name in TRANSFORMS` check would let through.
- *
- * @throws {UnknownTransformError} if `name` is not in the allowlist
- * @throws {URIError} from `urlencode` on lone-surrogate inputs — deliberate;
- *   v1 callers pass URL-derived captures that cannot legally contain these
- */
-export function applyTransform(name, input) {
-    if (!Object.hasOwn(TRANSFORMS, name)) {
-        throw new UnknownTransformError(name);
-    }
-    return TRANSFORMS[name](input);
-}
-//# sourceMappingURL=transforms.js.map

package/dist/link-auth/transforms.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transforms.js","sourceRoot":"","sources":["../../src/link-auth/transforms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,UAAU,GAAG;IACjB,SAAS,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;IACtE,SAAS,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE;CACS,CAAC;AAIjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,MAAM,CAAC,MAAM,CACvE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAoB,CAC3C,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,IAAY;QACtB,KAAK,CAAC,sBAAsB,IAAI,eAAe,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa;IACxD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,UAAU,CAAC,IAAqB,CAAC,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/dist/template-entry.d.ts

@@ -1,10 +0,0 @@
-/**
- * @vibe-agent-toolkit/utils/template
- *
- * Cached Handlebars rendering with HTML escaping disabled. Pure with respect
- * to Node builtins, but it pulls in `handlebars` (and transitively
- * `source-map`) — roughly 239KB bundled. Quarantined behind its own subpath
- * so importing a path helper never pays for it.
- */
-export * from './template.js';
-//# sourceMappingURL=template-entry.d.ts.map

package/dist/template-entry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template-entry.d.ts","sourceRoot":"","sources":["../src/template-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC"}

package/dist/template-entry.js

@@ -1,10 +0,0 @@
-/**
- * @vibe-agent-toolkit/utils/template
- *
- * Cached Handlebars rendering with HTML escaping disabled. Pure with respect
- * to Node builtins, but it pulls in `handlebars` (and transitively
- * `source-map`) — roughly 239KB bundled. Quarantined behind its own subpath
- * so importing a path helper never pays for it.
- */
-export * from './template.js';
-//# sourceMappingURL=template-entry.js.map

package/dist/template-entry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"template-entry.js","sourceRoot":"","sources":["../src/template-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAC"}

package/dist/template.d.ts

@@ -1,7 +0,0 @@
-/**
- * Render a Handlebars template with the given context.
- * Uses noEscape since this is for markdown content, not HTML.
- * Compiled templates are cached by template string.
- */
-export declare function renderTemplate(template: string, context: Record<string, unknown>): string;
-//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CASzF"}

package/dist/template.js

@@ -1,18 +0,0 @@
-import Handlebars from 'handlebars';
-const templateCache = new Map();
-/**
- * Render a Handlebars template with the given context.
- * Uses noEscape since this is for markdown content, not HTML.
- * Compiled templates are cached by template string.
- */
-export function renderTemplate(template, context) {
-    let compiled = templateCache.get(template);
-    if (!compiled) {
-        // Safe: templates render markdown/plaintext, not HTML. No XSS risk.
-        // eslint-disable-next-line sonarjs/disabled-auto-escaping
-        compiled = Handlebars.compile(template, { noEscape: true });
-        templateCache.set(template, compiled);
-    }
-    return compiled(context);
-}
-//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAsC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAgC;IAC/E,IAAI,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,oEAAoE;QACpE,0DAA0D;QAC1D,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}