@vibe-agent-toolkit/utils 0.2.0-rc.3 → 0.2.0-rc.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -13
- package/dist/crawl-timing.d.ts +43 -66
- package/dist/crawl-timing.d.ts.map +1 -1
- package/dist/crawl-timing.js +35 -79
- package/dist/crawl-timing.js.map +1 -1
- package/dist/crawl.d.ts +2 -4
- package/dist/crawl.d.ts.map +1 -1
- package/dist/crawl.js +2 -4
- package/dist/crawl.js.map +1 -1
- package/dist/fs-utils.d.ts +15 -6
- package/dist/fs-utils.d.ts.map +1 -1
- package/dist/fs-utils.js +15 -6
- package/dist/fs-utils.js.map +1 -1
- package/dist/git-tracker.d.ts +32 -1
- package/dist/git-tracker.d.ts.map +1 -1
- package/dist/git-tracker.js +32 -1
- package/dist/git-tracker.js.map +1 -1
- package/dist/git.d.ts +11 -4
- package/dist/git.d.ts.map +1 -1
- package/dist/git.js +11 -4
- package/dist/git.js.map +1 -1
- package/dist/index.d.ts +19 -20
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +19 -41
- package/dist/index.js.map +1 -1
- package/dist/project.d.ts +7 -5
- package/dist/project.d.ts.map +1 -1
- package/dist/project.js +7 -5
- package/dist/project.js.map +1 -1
- package/dist/safe-exec.js +0 -1
- package/dist/safe-exec.js.map +1 -1
- package/dist/spawn-hardened.js +0 -1
- package/dist/spawn-hardened.js.map +1 -1
- package/dist/testing.d.ts +73 -3
- package/dist/testing.d.ts.map +1 -1
- package/dist/testing.js +93 -3
- package/dist/testing.js.map +1 -1
- package/dist/timing-dump.d.ts +22 -5
- package/dist/timing-dump.d.ts.map +1 -1
- package/dist/timing-dump.js +89 -23
- package/dist/timing-dump.js.map +1 -1
- package/eslint/index.cjs +9 -0
- package/eslint/index.d.cts +14 -7
- package/eslint/rules/no-process-exit-in-phase.cjs +117 -0
- package/package.json +5 -7
- package/dist/link-auth/build-headers.d.ts +0 -34
- package/dist/link-auth/build-headers.d.ts.map +0 -1
- package/dist/link-auth/build-headers.js +0 -58
- package/dist/link-auth/build-headers.js.map +0 -1
- package/dist/link-auth/expand-macro.d.ts +0 -38
- package/dist/link-auth/expand-macro.d.ts.map +0 -1
- package/dist/link-auth/expand-macro.js +0 -139
- package/dist/link-auth/expand-macro.js.map +0 -1
- package/dist/link-auth/macros.yaml +0 -50
- package/dist/link-auth/resolve-token.d.ts +0 -83
- package/dist/link-auth/resolve-token.d.ts.map +0 -1
- package/dist/link-auth/resolve-token.js +0 -115
- package/dist/link-auth/resolve-token.js.map +0 -1
- package/dist/link-auth/resolve.d.ts +0 -102
- package/dist/link-auth/resolve.d.ts.map +0 -1
- package/dist/link-auth/resolve.js +0 -66
- package/dist/link-auth/resolve.js.map +0 -1
- package/dist/link-auth/rewrite.d.ts +0 -52
- package/dist/link-auth/rewrite.d.ts.map +0 -1
- package/dist/link-auth/rewrite.js +0 -102
- package/dist/link-auth/rewrite.js.map +0 -1
- package/dist/link-auth/select-provider.d.ts +0 -30
- package/dist/link-auth/select-provider.d.ts.map +0 -1
- package/dist/link-auth/select-provider.js +0 -55
- package/dist/link-auth/select-provider.js.map +0 -1
- package/dist/link-auth/template.d.ts +0 -40
- package/dist/link-auth/template.d.ts.map +0 -1
- package/dist/link-auth/template.js +0 -89
- package/dist/link-auth/template.js.map +0 -1
- package/dist/link-auth/transforms.d.ts +0 -46
- package/dist/link-auth/transforms.d.ts.map +0 -1
- package/dist/link-auth/transforms.js +0 -52
- package/dist/link-auth/transforms.js.map +0 -1
- package/dist/template-entry.d.ts +0 -10
- package/dist/template-entry.d.ts.map +0 -1
- package/dist/template-entry.js +0 -10
- package/dist/template-entry.js.map +0 -1
- package/dist/template.d.ts +0 -7
- package/dist/template.d.ts.map +0 -1
- package/dist/template.js +0 -18
- package/dist/template.js.map +0 -1
|
@@ -1,102 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Public API for the linkAuth pure engine.
|
|
3
|
-
*
|
|
4
|
-
* `resolveAuthenticatedUrl(url, config)` is the single entry point per design
|
|
5
|
-
* §6: select the first provider whose `match.host` claims the URL, run its
|
|
6
|
-
* rewrite pipeline, resolve a token, build the auth headers, and return
|
|
7
|
-
* everything the caller needs to issue an authenticated fetch.
|
|
8
|
-
*
|
|
9
|
-
* Three outcomes:
|
|
10
|
-
* - `{ fetchUrl, headers }` — ready to fetch (provider claimed,
|
|
11
|
-
* rewrite matched, token resolved)
|
|
12
|
-
* - `{ outcome: 'unsupported' }` — no provider claims the host, OR
|
|
13
|
-
* host matched but no rewrite did
|
|
14
|
-
* (per §4: "the provider does not
|
|
15
|
-
* claim the URL for rewriting")
|
|
16
|
-
* - `{ outcome: 'unverified', reason }` — claimed and rewrote, but no token
|
|
17
|
-
* source resolved a non-empty value
|
|
18
|
-
*
|
|
19
|
-
* Per design issue #113 §6.
|
|
20
|
-
*/
|
|
21
|
-
import { type TokenResolutionDeps, type TokenSource } from './resolve-token.js';
|
|
22
|
-
import { type RewriteRule } from './rewrite.js';
|
|
23
|
-
import { type ProviderMatch } from './select-provider.js';
|
|
24
|
-
export interface ProviderAuth {
|
|
25
|
-
readonly headers: Record<string, string>;
|
|
26
|
-
}
|
|
27
|
-
/**
|
|
28
|
-
* Optional content-fetch header overrides (design issue #113 §6.2).
|
|
29
|
-
*
|
|
30
|
-
* Health-check and content retrieval often need different `Accept` (or other)
|
|
31
|
-
* headers. The canonical example: GitHub's `application/vnd.github+json`
|
|
32
|
-
* returns 200 for any size but omits bytes >1 MiB, while
|
|
33
|
-
* `application/vnd.github.raw` streams the bytes inline. The provider declares
|
|
34
|
-
* `auth.headers` for health-check and an optional `fetch.headers` for content
|
|
35
|
-
* retrieval. Both are templated against the same context (URL captures + token).
|
|
36
|
-
*/
|
|
37
|
-
export interface ProviderFetch {
|
|
38
|
-
readonly headers: Record<string, string>;
|
|
39
|
-
}
|
|
40
|
-
export interface ProviderCheck {
|
|
41
|
-
readonly method: 'GET' | 'HEAD';
|
|
42
|
-
readonly aliveStatus: readonly number[];
|
|
43
|
-
readonly notFoundMeaning: 'ambiguous' | 'dead';
|
|
44
|
-
}
|
|
45
|
-
export interface Provider {
|
|
46
|
-
readonly match: ProviderMatch;
|
|
47
|
-
readonly rewrite: readonly RewriteRule[];
|
|
48
|
-
readonly auth: ProviderAuth;
|
|
49
|
-
/**
|
|
50
|
-
* Optional — present when a provider needs different headers for content
|
|
51
|
-
* retrieval than for health-check. Absent for hosts where one header set
|
|
52
|
-
* does both jobs.
|
|
53
|
-
*/
|
|
54
|
-
readonly fetch?: ProviderFetch;
|
|
55
|
-
readonly token: readonly TokenSource[];
|
|
56
|
-
readonly check: ProviderCheck;
|
|
57
|
-
}
|
|
58
|
-
export interface LinkAuthConfig {
|
|
59
|
-
readonly providers: readonly Provider[];
|
|
60
|
-
/**
|
|
61
|
-
* Optional content-cache config (consumed by the slice-3 content-fetch
|
|
62
|
-
* primitive, not by the engine itself). The engine stays stateless; this
|
|
63
|
-
* field rides along on the config object so the primitive doesn't need a
|
|
64
|
-
* second source of truth.
|
|
65
|
-
*/
|
|
66
|
-
readonly cache?: {
|
|
67
|
-
readonly ttlMinutes?: number;
|
|
68
|
-
};
|
|
69
|
-
}
|
|
70
|
-
export type ResolveOutcome = {
|
|
71
|
-
readonly fetchUrl: string;
|
|
72
|
-
readonly headers: Record<string, string>;
|
|
73
|
-
/**
|
|
74
|
-
* Expanded fetch-mode headers, only present when the provider declared
|
|
75
|
-
* a `fetch` block. Templated against the same context as `headers`
|
|
76
|
-
* (URL captures + resolved token), so callers do not need to re-resolve
|
|
77
|
-
* the token to send these. Per §6.2 — content-fetch consumers send
|
|
78
|
-
* these instead of (or merged over) `headers` for the request body.
|
|
79
|
-
*/
|
|
80
|
-
readonly fetchHeaders?: Record<string, string>;
|
|
81
|
-
/**
|
|
82
|
-
* The matched provider's `check` block, passed through so the post-fetch
|
|
83
|
-
* classifier (in `packages/resources`) can route status codes to outcomes
|
|
84
|
-
* without re-running `selectProvider`. Reading this from the engine —
|
|
85
|
-
* rather than asking the validator to re-derive it — keeps the
|
|
86
|
-
* provider-match decision in exactly one place.
|
|
87
|
-
*/
|
|
88
|
-
readonly check: ProviderCheck;
|
|
89
|
-
} | {
|
|
90
|
-
readonly outcome: 'unsupported';
|
|
91
|
-
} | {
|
|
92
|
-
readonly outcome: 'unverified';
|
|
93
|
-
readonly reason: string;
|
|
94
|
-
};
|
|
95
|
-
/**
|
|
96
|
-
* Resolve an authenticated fetch plan for `url` against the configured providers.
|
|
97
|
-
*
|
|
98
|
-
* @param deps - Optional dependency injection for token resolution (`env` map
|
|
99
|
-
* + `runCommand`). Production callers omit this; tests supply mocks.
|
|
100
|
-
*/
|
|
101
|
-
export declare function resolveAuthenticatedUrl(url: string, config: LinkAuthConfig, deps?: Partial<TokenResolutionDeps>): ResolveOutcome;
|
|
102
|
-
//# sourceMappingURL=resolve.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/link-auth/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,sBAAsB,CAAC;AAE1E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,WAAW,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B,GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GACnC;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAClC,cAAc,CAqChB"}
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Public API for the linkAuth pure engine.
|
|
3
|
-
*
|
|
4
|
-
* `resolveAuthenticatedUrl(url, config)` is the single entry point per design
|
|
5
|
-
* §6: select the first provider whose `match.host` claims the URL, run its
|
|
6
|
-
* rewrite pipeline, resolve a token, build the auth headers, and return
|
|
7
|
-
* everything the caller needs to issue an authenticated fetch.
|
|
8
|
-
*
|
|
9
|
-
* Three outcomes:
|
|
10
|
-
* - `{ fetchUrl, headers }` — ready to fetch (provider claimed,
|
|
11
|
-
* rewrite matched, token resolved)
|
|
12
|
-
* - `{ outcome: 'unsupported' }` — no provider claims the host, OR
|
|
13
|
-
* host matched but no rewrite did
|
|
14
|
-
* (per §4: "the provider does not
|
|
15
|
-
* claim the URL for rewriting")
|
|
16
|
-
* - `{ outcome: 'unverified', reason }` — claimed and rewrote, but no token
|
|
17
|
-
* source resolved a non-empty value
|
|
18
|
-
*
|
|
19
|
-
* Per design issue #113 §6.
|
|
20
|
-
*/
|
|
21
|
-
import { buildHeaders } from './build-headers.js';
|
|
22
|
-
import { resolveToken, } from './resolve-token.js';
|
|
23
|
-
import { rewriteUrl } from './rewrite.js';
|
|
24
|
-
import { selectProvider } from './select-provider.js';
|
|
25
|
-
/**
|
|
26
|
-
* Resolve an authenticated fetch plan for `url` against the configured providers.
|
|
27
|
-
*
|
|
28
|
-
* @param deps - Optional dependency injection for token resolution (`env` map
|
|
29
|
-
* + `runCommand`). Production callers omit this; tests supply mocks.
|
|
30
|
-
*/
|
|
31
|
-
export function resolveAuthenticatedUrl(url, config, deps) {
|
|
32
|
-
const provider = selectProvider(url, config.providers);
|
|
33
|
-
if (provider === undefined)
|
|
34
|
-
return { outcome: 'unsupported' };
|
|
35
|
-
const rewrite = rewriteUrl(url, provider.rewrite);
|
|
36
|
-
if (!rewrite.matched)
|
|
37
|
-
return { outcome: 'unsupported' };
|
|
38
|
-
const token = resolveToken(provider.token, deps);
|
|
39
|
-
// eslint-disable-next-line security/detect-possible-timing-attacks -- compare to undefined sentinel, not secret content
|
|
40
|
-
if (token === undefined) {
|
|
41
|
-
return {
|
|
42
|
-
outcome: 'unverified',
|
|
43
|
-
reason: 'No token source resolved a non-empty value — configure `token` or log in.',
|
|
44
|
-
};
|
|
45
|
-
}
|
|
46
|
-
// Headers see captures + vars + the resolved token. The resolved token wins
|
|
47
|
-
// over any regex capture named "token" (later in Object.assign wins), so
|
|
48
|
-
// URL-derived data never leaks into Authorization values.
|
|
49
|
-
const headerContext = Object.create(null);
|
|
50
|
-
Object.assign(headerContext, rewrite.context);
|
|
51
|
-
headerContext['token'] = token;
|
|
52
|
-
const headers = buildHeaders(provider.auth.headers, headerContext);
|
|
53
|
-
// Expand fetch.headers against the same context so the resolved token wins
|
|
54
|
-
// over any URL-captured "token" group here too — the precedence discipline
|
|
55
|
-
// applies to both header sets, not just auth.headers.
|
|
56
|
-
const fetchHeaders = provider.fetch === undefined
|
|
57
|
-
? undefined
|
|
58
|
-
: buildHeaders(provider.fetch.headers, headerContext);
|
|
59
|
-
return {
|
|
60
|
-
fetchUrl: rewrite.rewrittenUrl,
|
|
61
|
-
headers,
|
|
62
|
-
...(fetchHeaders === undefined ? {} : { fetchHeaders }),
|
|
63
|
-
check: provider.check,
|
|
64
|
-
};
|
|
65
|
-
}
|
|
66
|
-
//# sourceMappingURL=resolve.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/link-auth/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAoB,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAsB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA6E1E;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAW,EACX,MAAsB,EACtB,IAAmC;IAEnC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAE9D,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAExD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjD,wHAAwH;IACxH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,2EAA2E;SACpF,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,yEAAyE;IACzE,0DAA0D;IAC1D,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B,CAAC;IACpE,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,aAAa,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;IAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACnE,2EAA2E;IAC3E,2EAA2E;IAC3E,sDAAsD;IACtD,MAAM,YAAY,GAChB,QAAQ,CAAC,KAAK,KAAK,SAAS;QAC1B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC1D,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,YAAY;QAC9B,OAAO;QACP,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;QACvD,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC"}
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Rewrite pipeline: ordered when → vars → to.
|
|
3
|
-
*
|
|
4
|
-
* Each provider declares one or more rewrite rules. For an input URL the
|
|
5
|
-
* pipeline strips `?query` and `#fragment`, finds the first rule whose
|
|
6
|
-
* `when` regex matches, computes `vars` (templates over captures), and
|
|
7
|
-
* renders the `to` template against captures + vars merged. The merged
|
|
8
|
-
* context flows out so downstream header templates can interpolate the
|
|
9
|
-
* same variables.
|
|
10
|
-
*
|
|
11
|
-
* Per design issue #113 §4 (vocabulary) and §5.2 (fragment/query
|
|
12
|
-
* stripping must precede a greedy `(?<path>.+)` capture).
|
|
13
|
-
*/
|
|
14
|
-
export interface RewriteRule {
|
|
15
|
-
readonly when: string;
|
|
16
|
-
readonly vars?: Record<string, string>;
|
|
17
|
-
readonly to: string;
|
|
18
|
-
}
|
|
19
|
-
export type RewriteOutcome = {
|
|
20
|
-
readonly matched: true;
|
|
21
|
-
readonly rewrittenUrl: string;
|
|
22
|
-
readonly context: Record<string, string>;
|
|
23
|
-
} | {
|
|
24
|
-
readonly matched: false;
|
|
25
|
-
};
|
|
26
|
-
/**
|
|
27
|
-
* Thrown when a rule's `when` field is not a compilable regex.
|
|
28
|
-
*/
|
|
29
|
-
export declare class InvalidRewriteRuleError extends Error {
|
|
30
|
-
constructor(pattern: string, cause: unknown);
|
|
31
|
-
}
|
|
32
|
-
/**
|
|
33
|
-
* Thrown when a `vars` key collides with a named capture in `when`.
|
|
34
|
-
* Adopter must rename one — vars cannot shadow captures (the design's
|
|
35
|
-
* intent is captures + vars in a single namespace).
|
|
36
|
-
*/
|
|
37
|
-
export declare class VarCaptureCollisionError extends Error {
|
|
38
|
-
constructor(name: string);
|
|
39
|
-
}
|
|
40
|
-
/**
|
|
41
|
-
* Apply an ordered list of rewrite rules to a URL.
|
|
42
|
-
*
|
|
43
|
-
* @returns `{ matched: true, rewrittenUrl, context }` for the first matching
|
|
44
|
-
* rule, or `{ matched: false }` if no rule claims the URL.
|
|
45
|
-
* @throws {InvalidRewriteRuleError} if a `when` field does not compile
|
|
46
|
-
* @throws {VarCaptureCollisionError} if a vars name shadows a capture name
|
|
47
|
-
* @throws {TemplateMissingVarError} from a template referencing an unknown name
|
|
48
|
-
* @throws {TemplateSyntaxError} from a malformed template expression
|
|
49
|
-
* @throws {UnknownTransformError} from a template calling an unknown transform
|
|
50
|
-
*/
|
|
51
|
-
export declare function rewriteUrl(url: string, rules: readonly RewriteRule[]): RewriteOutcome;
|
|
52
|
-
//# sourceMappingURL=rewrite.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../../src/link-auth/rewrite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAEhC;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAK5C;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,IAAI,EAAE,MAAM;CAMzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,cAAc,CAerF"}
|
|
@@ -1,102 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Rewrite pipeline: ordered when → vars → to.
|
|
3
|
-
*
|
|
4
|
-
* Each provider declares one or more rewrite rules. For an input URL the
|
|
5
|
-
* pipeline strips `?query` and `#fragment`, finds the first rule whose
|
|
6
|
-
* `when` regex matches, computes `vars` (templates over captures), and
|
|
7
|
-
* renders the `to` template against captures + vars merged. The merged
|
|
8
|
-
* context flows out so downstream header templates can interpolate the
|
|
9
|
-
* same variables.
|
|
10
|
-
*
|
|
11
|
-
* Per design issue #113 §4 (vocabulary) and §5.2 (fragment/query
|
|
12
|
-
* stripping must precede a greedy `(?<path>.+)` capture).
|
|
13
|
-
*/
|
|
14
|
-
import { renderTemplate } from './template.js';
|
|
15
|
-
/**
|
|
16
|
-
* Thrown when a rule's `when` field is not a compilable regex.
|
|
17
|
-
*/
|
|
18
|
-
export class InvalidRewriteRuleError extends Error {
|
|
19
|
-
constructor(pattern, cause) {
|
|
20
|
-
const reason = cause instanceof Error ? cause.message : String(cause);
|
|
21
|
-
super(`Invalid rewrite rule "when" regex: ${pattern}. ${reason}`);
|
|
22
|
-
this.name = 'InvalidRewriteRuleError';
|
|
23
|
-
}
|
|
24
|
-
}
|
|
25
|
-
/**
|
|
26
|
-
* Thrown when a `vars` key collides with a named capture in `when`.
|
|
27
|
-
* Adopter must rename one — vars cannot shadow captures (the design's
|
|
28
|
-
* intent is captures + vars in a single namespace).
|
|
29
|
-
*/
|
|
30
|
-
export class VarCaptureCollisionError extends Error {
|
|
31
|
-
constructor(name) {
|
|
32
|
-
super(`Rewrite var "${name}" collides with a regex capture of the same name. Rename one.`);
|
|
33
|
-
this.name = 'VarCaptureCollisionError';
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
/**
|
|
37
|
-
* Apply an ordered list of rewrite rules to a URL.
|
|
38
|
-
*
|
|
39
|
-
* @returns `{ matched: true, rewrittenUrl, context }` for the first matching
|
|
40
|
-
* rule, or `{ matched: false }` if no rule claims the URL.
|
|
41
|
-
* @throws {InvalidRewriteRuleError} if a `when` field does not compile
|
|
42
|
-
* @throws {VarCaptureCollisionError} if a vars name shadows a capture name
|
|
43
|
-
* @throws {TemplateMissingVarError} from a template referencing an unknown name
|
|
44
|
-
* @throws {TemplateSyntaxError} from a malformed template expression
|
|
45
|
-
* @throws {UnknownTransformError} from a template calling an unknown transform
|
|
46
|
-
*/
|
|
47
|
-
export function rewriteUrl(url, rules) {
|
|
48
|
-
const stripped = stripFragmentAndQuery(url);
|
|
49
|
-
for (const rule of rules) {
|
|
50
|
-
const regex = compileWhen(rule.when);
|
|
51
|
-
const match = regex.exec(stripped);
|
|
52
|
-
if (match === null)
|
|
53
|
-
continue;
|
|
54
|
-
const captures = collectCaptures(match);
|
|
55
|
-
const context = computeContext(captures, rule.vars);
|
|
56
|
-
const rewrittenUrl = renderTemplate(rule.to, context);
|
|
57
|
-
return { matched: true, rewrittenUrl, context };
|
|
58
|
-
}
|
|
59
|
-
return { matched: false };
|
|
60
|
-
}
|
|
61
|
-
function stripFragmentAndQuery(url) {
|
|
62
|
-
const idx = url.search(/[?#]/);
|
|
63
|
-
return idx === -1 ? url : url.slice(0, idx);
|
|
64
|
-
}
|
|
65
|
-
function compileWhen(pattern) {
|
|
66
|
-
try {
|
|
67
|
-
// Rule patterns originate in trusted config (see design §8); runtime
|
|
68
|
-
// compilation is intentional, not user-input regex injection.
|
|
69
|
-
// eslint-disable-next-line security/detect-non-literal-regexp
|
|
70
|
-
return new RegExp(pattern);
|
|
71
|
-
}
|
|
72
|
-
catch (e) {
|
|
73
|
-
throw new InvalidRewriteRuleError(pattern, e);
|
|
74
|
-
}
|
|
75
|
-
}
|
|
76
|
-
function collectCaptures(match) {
|
|
77
|
-
const captures = Object.create(null);
|
|
78
|
-
// The lib typedef for RegExpMatchArray.groups says values are `string`, but
|
|
79
|
-
// optional named groups that did not match show up at runtime as `undefined`.
|
|
80
|
-
// Cast to reflect runtime reality so the filter below is type-meaningful.
|
|
81
|
-
const groups = (match.groups ?? {});
|
|
82
|
-
for (const [key, value] of Object.entries(groups)) {
|
|
83
|
-
if (value !== undefined) {
|
|
84
|
-
captures[key] = value;
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
return captures;
|
|
88
|
-
}
|
|
89
|
-
function computeContext(captures, vars) {
|
|
90
|
-
const context = Object.create(null);
|
|
91
|
-
Object.assign(context, captures);
|
|
92
|
-
if (vars === undefined)
|
|
93
|
-
return context;
|
|
94
|
-
for (const [name, template] of Object.entries(vars)) {
|
|
95
|
-
if (Object.hasOwn(captures, name)) {
|
|
96
|
-
throw new VarCaptureCollisionError(name);
|
|
97
|
-
}
|
|
98
|
-
context[name] = renderTemplate(template, captures);
|
|
99
|
-
}
|
|
100
|
-
return context;
|
|
101
|
-
}
|
|
102
|
-
//# sourceMappingURL=rewrite.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"rewrite.js","sourceRoot":"","sources":["../../src/link-auth/rewrite.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Provider selection by URL host.
|
|
3
|
-
*
|
|
4
|
-
* Iterates the configured providers in order; the first one whose `match.host`
|
|
5
|
-
* glob matches the URL hostname (and no `match.excludeHost` glob excludes it)
|
|
6
|
-
* claims the URL. Returns `undefined` if no provider claims it — the caller
|
|
7
|
-
* then falls back to anonymous link-checking.
|
|
8
|
-
*
|
|
9
|
-
* Hostname matching is case-insensitive per RFC 3986. Pattern syntax follows
|
|
10
|
-
* `picomatch` (already a utils dep): `*` matches any character, `**` matches
|
|
11
|
-
* across `/`. For hostnames (no slashes) the practical effect is that `*`
|
|
12
|
-
* happily matches dots — e.g. `*.sharepoint.com` claims both
|
|
13
|
-
* `contoso.sharepoint.com` and `foo.bar.sharepoint.com`.
|
|
14
|
-
*
|
|
15
|
-
* Per design issue #113 §4 (vocabulary item 1: match.host + excludeHost).
|
|
16
|
-
*/
|
|
17
|
-
export interface ProviderMatch {
|
|
18
|
-
readonly host: string;
|
|
19
|
-
readonly excludeHost?: readonly string[];
|
|
20
|
-
}
|
|
21
|
-
/**
|
|
22
|
-
* Find the first provider whose `match` claims the given URL.
|
|
23
|
-
*
|
|
24
|
-
* @returns the matching provider, or `undefined` if none claim the URL (no
|
|
25
|
-
* pattern matched, all candidates were excluded, or the URL is malformed).
|
|
26
|
-
*/
|
|
27
|
-
export declare function selectProvider<P extends {
|
|
28
|
-
readonly match: ProviderMatch;
|
|
29
|
-
}>(url: string, providers: readonly P[]): P | undefined;
|
|
30
|
-
//# sourceMappingURL=select-provider.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"select-provider.d.ts","sourceRoot":"","sources":["../../src/link-auth/select-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,EACxE,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,SAAS,CAAC,EAAE,GACtB,CAAC,GAAG,SAAS,CAUf"}
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Provider selection by URL host.
|
|
3
|
-
*
|
|
4
|
-
* Iterates the configured providers in order; the first one whose `match.host`
|
|
5
|
-
* glob matches the URL hostname (and no `match.excludeHost` glob excludes it)
|
|
6
|
-
* claims the URL. Returns `undefined` if no provider claims it — the caller
|
|
7
|
-
* then falls back to anonymous link-checking.
|
|
8
|
-
*
|
|
9
|
-
* Hostname matching is case-insensitive per RFC 3986. Pattern syntax follows
|
|
10
|
-
* `picomatch` (already a utils dep): `*` matches any character, `**` matches
|
|
11
|
-
* across `/`. For hostnames (no slashes) the practical effect is that `*`
|
|
12
|
-
* happily matches dots — e.g. `*.sharepoint.com` claims both
|
|
13
|
-
* `contoso.sharepoint.com` and `foo.bar.sharepoint.com`.
|
|
14
|
-
*
|
|
15
|
-
* Per design issue #113 §4 (vocabulary item 1: match.host + excludeHost).
|
|
16
|
-
*/
|
|
17
|
-
import picomatch from 'picomatch';
|
|
18
|
-
/**
|
|
19
|
-
* Find the first provider whose `match` claims the given URL.
|
|
20
|
-
*
|
|
21
|
-
* @returns the matching provider, or `undefined` if none claim the URL (no
|
|
22
|
-
* pattern matched, all candidates were excluded, or the URL is malformed).
|
|
23
|
-
*/
|
|
24
|
-
export function selectProvider(url, providers) {
|
|
25
|
-
const host = extractHostname(url);
|
|
26
|
-
if (host === undefined)
|
|
27
|
-
return undefined;
|
|
28
|
-
for (const provider of providers) {
|
|
29
|
-
if (matches(host, provider.match)) {
|
|
30
|
-
return provider;
|
|
31
|
-
}
|
|
32
|
-
}
|
|
33
|
-
return undefined;
|
|
34
|
-
}
|
|
35
|
-
function extractHostname(url) {
|
|
36
|
-
try {
|
|
37
|
-
return new URL(url).hostname;
|
|
38
|
-
}
|
|
39
|
-
catch {
|
|
40
|
-
return undefined;
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
function matches(host, match) {
|
|
44
|
-
const lowerHost = host.toLowerCase();
|
|
45
|
-
if (!picomatch.isMatch(lowerHost, match.host.toLowerCase()))
|
|
46
|
-
return false;
|
|
47
|
-
if (match.excludeHost !== undefined) {
|
|
48
|
-
for (const pattern of match.excludeHost) {
|
|
49
|
-
if (picomatch.isMatch(lowerHost, pattern.toLowerCase()))
|
|
50
|
-
return false;
|
|
51
|
-
}
|
|
52
|
-
}
|
|
53
|
-
return true;
|
|
54
|
-
}
|
|
55
|
-
//# sourceMappingURL=select-provider.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"select-provider.js","sourceRoot":"","sources":["../../src/link-auth/select-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,SAAS,MAAM,WAAW,CAAC;AAOlC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,SAAuB;IAEvB,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,KAAoB;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1E,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;gBAAE,OAAO,KAAK,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Tiny template renderer for linkAuth rewrite + header templates.
|
|
3
|
-
*
|
|
4
|
-
* Syntax (strict, no escapes, no nesting):
|
|
5
|
-
* - `${name}` → context[name]
|
|
6
|
-
* - `${transform(name)}` → applyTransform(transform, context[name])
|
|
7
|
-
*
|
|
8
|
-
* Anything else inside `${...}` throws `TemplateSyntaxError`. Missing context
|
|
9
|
-
* keys throw `TemplateMissingVarError`. Unknown transform names propagate
|
|
10
|
-
* `UnknownTransformError` from the transforms allowlist.
|
|
11
|
-
*
|
|
12
|
-
* This is NOT the project's general-purpose Handlebars renderer
|
|
13
|
-
* (`utils/template.ts`) — that one is `{{...}}` and consumed widely. linkAuth
|
|
14
|
-
* needs different syntax and a closed transform set; the two coexist by
|
|
15
|
-
* namespace (`link-auth/template.ts`).
|
|
16
|
-
*/
|
|
17
|
-
/**
|
|
18
|
-
* Thrown when a template references a variable not present in the context.
|
|
19
|
-
* Message names the missing variable and includes the full template for
|
|
20
|
-
* caller-side debugging.
|
|
21
|
-
*/
|
|
22
|
-
export declare class TemplateMissingVarError extends Error {
|
|
23
|
-
constructor(varName: string, template: string);
|
|
24
|
-
}
|
|
25
|
-
/**
|
|
26
|
-
* Thrown when a template contains syntactically invalid content inside `${...}`
|
|
27
|
-
* (empty expression, whitespace, unrecognized form) or an unterminated `${`.
|
|
28
|
-
*/
|
|
29
|
-
export declare class TemplateSyntaxError extends Error {
|
|
30
|
-
constructor(detail: string, template: string);
|
|
31
|
-
}
|
|
32
|
-
/**
|
|
33
|
-
* Render a template by substituting `${...}` expressions from a context map.
|
|
34
|
-
*
|
|
35
|
-
* @throws {TemplateMissingVarError} if a referenced variable is absent
|
|
36
|
-
* @throws {TemplateSyntaxError} for invalid expressions or unterminated `${`
|
|
37
|
-
* @throws {UnknownTransformError} from a `${transform(name)}` call
|
|
38
|
-
*/
|
|
39
|
-
export declare function renderTemplate(template: string, context: Record<string, string>): string;
|
|
40
|
-
//# sourceMappingURL=template.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/link-auth/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAI9C;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAI7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAUxF"}
|
|
@@ -1,89 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Tiny template renderer for linkAuth rewrite + header templates.
|
|
3
|
-
*
|
|
4
|
-
* Syntax (strict, no escapes, no nesting):
|
|
5
|
-
* - `${name}` → context[name]
|
|
6
|
-
* - `${transform(name)}` → applyTransform(transform, context[name])
|
|
7
|
-
*
|
|
8
|
-
* Anything else inside `${...}` throws `TemplateSyntaxError`. Missing context
|
|
9
|
-
* keys throw `TemplateMissingVarError`. Unknown transform names propagate
|
|
10
|
-
* `UnknownTransformError` from the transforms allowlist.
|
|
11
|
-
*
|
|
12
|
-
* This is NOT the project's general-purpose Handlebars renderer
|
|
13
|
-
* (`utils/template.ts`) — that one is `{{...}}` and consumed widely. linkAuth
|
|
14
|
-
* needs different syntax and a closed transform set; the two coexist by
|
|
15
|
-
* namespace (`link-auth/template.ts`).
|
|
16
|
-
*/
|
|
17
|
-
import { applyTransform } from './transforms.js';
|
|
18
|
-
const IDENTIFIER = /^[a-zA-Z_]\w*$/;
|
|
19
|
-
const TRANSFORM_CALL = /^(?<fn>[a-zA-Z_]\w*)\((?<arg>[a-zA-Z_]\w*)\)$/;
|
|
20
|
-
/**
|
|
21
|
-
* Thrown when a template references a variable not present in the context.
|
|
22
|
-
* Message names the missing variable and includes the full template for
|
|
23
|
-
* caller-side debugging.
|
|
24
|
-
*/
|
|
25
|
-
export class TemplateMissingVarError extends Error {
|
|
26
|
-
constructor(varName, template) {
|
|
27
|
-
super(`Template variable "${varName}" not in context. Template: ${template}`);
|
|
28
|
-
this.name = 'TemplateMissingVarError';
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
/**
|
|
32
|
-
* Thrown when a template contains syntactically invalid content inside `${...}`
|
|
33
|
-
* (empty expression, whitespace, unrecognized form) or an unterminated `${`.
|
|
34
|
-
*/
|
|
35
|
-
export class TemplateSyntaxError extends Error {
|
|
36
|
-
constructor(detail, template) {
|
|
37
|
-
super(`Invalid template syntax — ${detail}. Template: ${template}`);
|
|
38
|
-
this.name = 'TemplateSyntaxError';
|
|
39
|
-
}
|
|
40
|
-
}
|
|
41
|
-
/**
|
|
42
|
-
* Render a template by substituting `${...}` expressions from a context map.
|
|
43
|
-
*
|
|
44
|
-
* @throws {TemplateMissingVarError} if a referenced variable is absent
|
|
45
|
-
* @throws {TemplateSyntaxError} for invalid expressions or unterminated `${`
|
|
46
|
-
* @throws {UnknownTransformError} from a `${transform(name)}` call
|
|
47
|
-
*/
|
|
48
|
-
export function renderTemplate(template, context) {
|
|
49
|
-
const rendered = template.replaceAll(/\$\{([^}]*)\}/g, (_match, body) => resolveExpression(body, template, context));
|
|
50
|
-
if (rendered.includes('${')) {
|
|
51
|
-
throw new TemplateSyntaxError('unterminated "${" with no matching "}"', template);
|
|
52
|
-
}
|
|
53
|
-
return rendered;
|
|
54
|
-
}
|
|
55
|
-
function resolveExpression(body, template, context) {
|
|
56
|
-
if (body !== body.trim()) {
|
|
57
|
-
throw new TemplateSyntaxError(`whitespace in "${body}"`, template);
|
|
58
|
-
}
|
|
59
|
-
if (IDENTIFIER.test(body)) {
|
|
60
|
-
return lookupContextVar(context, body, template);
|
|
61
|
-
}
|
|
62
|
-
const callMatch = TRANSFORM_CALL.exec(body);
|
|
63
|
-
if (callMatch?.groups !== undefined) {
|
|
64
|
-
const { fn, arg } = callMatch.groups;
|
|
65
|
-
if (fn === undefined || arg === undefined) {
|
|
66
|
-
throw new TemplateSyntaxError(`unexpected regex result for "${body}"`, template);
|
|
67
|
-
}
|
|
68
|
-
return applyTransform(fn, lookupContextVar(context, arg, template));
|
|
69
|
-
}
|
|
70
|
-
throw new TemplateSyntaxError(`unrecognized expression "${body}"`, template);
|
|
71
|
-
}
|
|
72
|
-
/**
|
|
73
|
-
* Fetch a variable from the context map, blocking prototype-chain bypass.
|
|
74
|
-
*
|
|
75
|
-
* Without `Object.hasOwn`, `context["__proto__"]` would return `Object.prototype`
|
|
76
|
-
* (a non-undefined object) and the renderer would substitute `[object Object]`
|
|
77
|
-
* into the output. Mirrors the closed-allowlist discipline in `transforms.ts`.
|
|
78
|
-
*/
|
|
79
|
-
function lookupContextVar(context, key, template) {
|
|
80
|
-
if (!Object.hasOwn(context, key)) {
|
|
81
|
-
throw new TemplateMissingVarError(key, template);
|
|
82
|
-
}
|
|
83
|
-
const value = context[key];
|
|
84
|
-
if (value === undefined) {
|
|
85
|
-
throw new TemplateMissingVarError(key, template);
|
|
86
|
-
}
|
|
87
|
-
return value;
|
|
88
|
-
}
|
|
89
|
-
//# sourceMappingURL=template.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"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"}
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Transform allowlist for linkAuth rewrite templates.
|
|
3
|
-
*
|
|
4
|
-
* Rewrite `to:` templates may call transforms over named regex captures —
|
|
5
|
-
* e.g. `${base64url(u)}` for Microsoft Graph share-ids. The allowed set is
|
|
6
|
-
* frozen in this file: adding a transform requires a VAT PR (see issue #113
|
|
7
|
-
* design §4.1). There is no arbitrary-evaluation path.
|
|
8
|
-
*
|
|
9
|
-
* v1 inputs are assumed to be ASCII URL host/path captures. Non-ASCII edge
|
|
10
|
-
* cases (lone surrogates) are pinned by tests so future regressions surface.
|
|
11
|
-
*/
|
|
12
|
-
declare const TRANSFORMS: {
|
|
13
|
-
readonly base64url: (s: string) => string;
|
|
14
|
-
readonly urlencode: (s: string) => string;
|
|
15
|
-
readonly lower: (s: string) => string;
|
|
16
|
-
};
|
|
17
|
-
export type TransformName = keyof typeof TRANSFORMS;
|
|
18
|
-
/**
|
|
19
|
-
* The closed allowlist of transform names. Callers parsing rewrite templates
|
|
20
|
-
* can validate transform calls (e.g. `${base64url(u)}`) against this list at
|
|
21
|
-
* config-load time, surfacing typos before any URL is rewritten.
|
|
22
|
-
*/
|
|
23
|
-
export declare const ALLOWED_TRANSFORMS: readonly TransformName[];
|
|
24
|
-
/**
|
|
25
|
-
* Thrown by `applyTransform` when called with a name not in the closed
|
|
26
|
-
* allowlist. The message names the bad transform and the full allowlist so
|
|
27
|
-
* a misconfigured macro surfaces a clear error at load time.
|
|
28
|
-
*/
|
|
29
|
-
export declare class UnknownTransformError extends Error {
|
|
30
|
-
constructor(name: string);
|
|
31
|
-
}
|
|
32
|
-
/**
|
|
33
|
-
* Dispatch a transform by name on a string input.
|
|
34
|
-
*
|
|
35
|
-
* Security claim: only the names in `ALLOWED_TRANSFORMS` resolve; any other
|
|
36
|
-
* input throws `UnknownTransformError`. Lookup uses `Object.hasOwn` to block
|
|
37
|
-
* prototype-chain keys (`toString`, `__proto__`, `constructor`, …) that a
|
|
38
|
-
* `name in TRANSFORMS` check would let through.
|
|
39
|
-
*
|
|
40
|
-
* @throws {UnknownTransformError} if `name` is not in the allowlist
|
|
41
|
-
* @throws {URIError} from `urlencode` on lone-surrogate inputs — deliberate;
|
|
42
|
-
* v1 callers pass URL-derived captures that cannot legally contain these
|
|
43
|
-
*/
|
|
44
|
-
export declare function applyTransform(name: string, input: string): string;
|
|
45
|
-
export {};
|
|
46
|
-
//# sourceMappingURL=transforms.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"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"}
|