@codelitdev/platform 0.1.0-alpha.0
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/LICENSE +21 -0
- package/README.md +11 -0
- package/dist/clock.d.ts +7 -0
- package/dist/clock.d.ts.map +1 -0
- package/dist/clock.js +14 -0
- package/dist/clock.js.map +1 -0
- package/dist/credentials.d.ts +49 -0
- package/dist/credentials.d.ts.map +1 -0
- package/dist/credentials.js +124 -0
- package/dist/credentials.js.map +1 -0
- package/dist/dates.d.ts +5 -0
- package/dist/dates.d.ts.map +1 -0
- package/dist/dates.js +26 -0
- package/dist/dates.js.map +1 -0
- package/dist/errors.d.ts +34 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +87 -0
- package/dist/errors.js.map +1 -0
- package/dist/ids.d.ts +13 -0
- package/dist/ids.d.ts.map +1 -0
- package/dist/ids.js +63 -0
- package/dist/ids.js.map +1 -0
- package/dist/index.d.ts +8 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -0
- package/dist/lifecycle.d.ts +26 -0
- package/dist/lifecycle.d.ts.map +1 -0
- package/dist/lifecycle.js +51 -0
- package/dist/lifecycle.js.map +1 -0
- package/dist/types.d.ts +53 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/package.json +45 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 CodeLit
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# @codelitdev/platform
|
|
2
|
+
|
|
3
|
+
Composition kernel for CodeLit products: request context, credential kinds,
|
|
4
|
+
safe errors, UUIDv7 / prefixed public IDs, health/readiness/shutdown, and
|
|
5
|
+
HTTP/MCP mapping conventions.
|
|
6
|
+
|
|
7
|
+
The package imports no product schema, reads no environment at import, and
|
|
8
|
+
performs no network I/O. Products implement authentication, tenant, and
|
|
9
|
+
authorization adapters.
|
|
10
|
+
|
|
11
|
+
See `docs/architecture.md` §6.4 and ADR 0001.
|
package/dist/clock.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,MAAM,KAAK,GAAG;IAClB,GAAG,IAAI,IAAI,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAIzB,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAAE,EAAE,IAAI,GAAG,KAAK,CAO3C"}
|
package/dist/clock.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"clock.js","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,WAAW,GAAU;IAChC,GAAG;QACD,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,EAAQ;IAClC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IACxB,OAAO;QACL,GAAG;YACD,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { PlatformError } from "./errors.js";
|
|
2
|
+
import type { AuthenticationResult, CredentialKind, PlatformCredential, TransportName } from "./types.js";
|
|
3
|
+
export type TransportCredentialKind = Exclude<CredentialKind, "system">;
|
|
4
|
+
export type PresentedCredential = {
|
|
5
|
+
kind: TransportCredentialKind;
|
|
6
|
+
secret: string;
|
|
7
|
+
};
|
|
8
|
+
export type HeaderMap = Readonly<Record<string, string | string[] | undefined>>;
|
|
9
|
+
export declare const DEFAULT_SESSION_COOKIE_NAME = "better-auth.session_token";
|
|
10
|
+
export declare const SECURE_SESSION_COOKIE_PREFIX = "__Secure-";
|
|
11
|
+
/**
|
|
12
|
+
* Collect credential mechanisms supplied on an HTTP request.
|
|
13
|
+
* Never produces `system`.
|
|
14
|
+
*/
|
|
15
|
+
export declare function extractHttpCredentials(headers: HeaderMap, options?: {
|
|
16
|
+
sessionCookieName?: string;
|
|
17
|
+
}): PresentedCredential[];
|
|
18
|
+
/**
|
|
19
|
+
* MCP accepts OAuth bearer or API key, not browser sessions.
|
|
20
|
+
* Never produces `system`.
|
|
21
|
+
*/
|
|
22
|
+
export declare function extractMcpCredentials(headers: HeaderMap): PresentedCredential[];
|
|
23
|
+
export type CredentialSelection = {
|
|
24
|
+
kind: "absent";
|
|
25
|
+
} | {
|
|
26
|
+
kind: "ambiguous";
|
|
27
|
+
error: PlatformError;
|
|
28
|
+
} | {
|
|
29
|
+
kind: "single";
|
|
30
|
+
credential: PresentedCredential;
|
|
31
|
+
};
|
|
32
|
+
export declare function selectSingleCredential(presented: readonly PresentedCredential[]): CredentialSelection;
|
|
33
|
+
export declare function selectHttpCredential(headers: HeaderMap, options?: {
|
|
34
|
+
sessionCookieName?: string;
|
|
35
|
+
}): CredentialSelection;
|
|
36
|
+
export declare function selectMcpCredential(headers: HeaderMap): CredentialSelection;
|
|
37
|
+
/**
|
|
38
|
+
* Map an authentication adapter result for a transport route.
|
|
39
|
+
* Protected routes map `absent` to `unauthenticated`.
|
|
40
|
+
* `rejected` is returned unchanged (no fallback).
|
|
41
|
+
* A `system` credential from HTTP/MCP mapping becomes `internal_error`.
|
|
42
|
+
*/
|
|
43
|
+
export declare function mapTransportAuthentication<PrincipalId extends string>(result: AuthenticationResult<PrincipalId>, options: {
|
|
44
|
+
publicRoute?: boolean;
|
|
45
|
+
transport: TransportName;
|
|
46
|
+
}): AuthenticationResult<PrincipalId>;
|
|
47
|
+
export declare function createSystemCredential(credentialId?: string): PlatformCredential;
|
|
48
|
+
export declare function isTransportCredentialKind(kind: CredentialKind): kind is TransportCredentialKind;
|
|
49
|
+
//# sourceMappingURL=credentials.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAExE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;AAEhF,eAAO,MAAM,2BAA2B,8BAA8B,CAAC;AACvE,eAAO,MAAM,4BAA4B,cAAc,CAAC;AAiCxD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,EAClB,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3C,mBAAmB,EAAE,CAiBvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,GAAG,mBAAmB,EAAE,CAS/E;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAExD,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,mBAAmB,EAAE,GACxC,mBAAmB,CASrB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,EAClB,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3C,mBAAmB,CAErB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,GAAG,mBAAmB,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,SAAS,MAAM,EACnE,MAAM,EAAE,oBAAoB,CAAC,WAAW,CAAC,EACzC,OAAO,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,GAC3D,oBAAoB,CAAC,WAAW,CAAC,CAkBnC;AAED,wBAAgB,sBAAsB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAIhF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,cAAc,GACnB,IAAI,IAAI,uBAAuB,CAEjC"}
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
import { createPlatformError } from "./errors.js";
|
|
2
|
+
export const DEFAULT_SESSION_COOKIE_NAME = "better-auth.session_token";
|
|
3
|
+
export const SECURE_SESSION_COOKIE_PREFIX = "__Secure-";
|
|
4
|
+
function headerValue(headers, name) {
|
|
5
|
+
const direct = headers[name] ?? headers[name.toLowerCase()];
|
|
6
|
+
if (Array.isArray(direct))
|
|
7
|
+
return direct[0];
|
|
8
|
+
return direct;
|
|
9
|
+
}
|
|
10
|
+
function parseCookie(cookieHeader, name) {
|
|
11
|
+
if (!cookieHeader)
|
|
12
|
+
return undefined;
|
|
13
|
+
for (const part of cookieHeader.split(";")) {
|
|
14
|
+
const trimmed = part.trim();
|
|
15
|
+
const eq = trimmed.indexOf("=");
|
|
16
|
+
if (eq <= 0)
|
|
17
|
+
continue;
|
|
18
|
+
const key = trimmed.slice(0, eq).trim();
|
|
19
|
+
if (key === name) {
|
|
20
|
+
const value = trimmed.slice(eq + 1).trim();
|
|
21
|
+
return value.length > 0 ? value : undefined;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
return undefined;
|
|
25
|
+
}
|
|
26
|
+
function bearerToken(authorization) {
|
|
27
|
+
if (!authorization)
|
|
28
|
+
return undefined;
|
|
29
|
+
const match = /^Bearer\s+(\S+)/i.exec(authorization.trim());
|
|
30
|
+
if (!match?.[1])
|
|
31
|
+
return undefined;
|
|
32
|
+
return match[1];
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Collect credential mechanisms supplied on an HTTP request.
|
|
36
|
+
* Never produces `system`.
|
|
37
|
+
*/
|
|
38
|
+
export function extractHttpCredentials(headers, options = {}) {
|
|
39
|
+
const sessionCookieName = options.sessionCookieName ?? DEFAULT_SESSION_COOKIE_NAME;
|
|
40
|
+
const presented = [];
|
|
41
|
+
const cookieHeader = headerValue(headers, "cookie");
|
|
42
|
+
// Better Auth prefixes cookies with `__Secure-` when it is configured for
|
|
43
|
+
// HTTPS. Both names represent the same browser-session mechanism.
|
|
44
|
+
const session = parseCookie(cookieHeader, sessionCookieName) ??
|
|
45
|
+
parseCookie(cookieHeader, `${SECURE_SESSION_COOKIE_PREFIX}${sessionCookieName}`);
|
|
46
|
+
if (session)
|
|
47
|
+
presented.push({ kind: "session", secret: session });
|
|
48
|
+
const oauth = bearerToken(headerValue(headers, "authorization"));
|
|
49
|
+
if (oauth)
|
|
50
|
+
presented.push({ kind: "oauth", secret: oauth });
|
|
51
|
+
const apiKey = headerValue(headers, "x-api-key");
|
|
52
|
+
if (apiKey && apiKey.length > 0) {
|
|
53
|
+
presented.push({ kind: "api_key", secret: apiKey });
|
|
54
|
+
}
|
|
55
|
+
return presented;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* MCP accepts OAuth bearer or API key, not browser sessions.
|
|
59
|
+
* Never produces `system`.
|
|
60
|
+
*/
|
|
61
|
+
export function extractMcpCredentials(headers) {
|
|
62
|
+
const presented = [];
|
|
63
|
+
const oauth = bearerToken(headerValue(headers, "authorization"));
|
|
64
|
+
if (oauth)
|
|
65
|
+
presented.push({ kind: "oauth", secret: oauth });
|
|
66
|
+
const apiKey = headerValue(headers, "x-api-key");
|
|
67
|
+
if (apiKey && apiKey.length > 0) {
|
|
68
|
+
presented.push({ kind: "api_key", secret: apiKey });
|
|
69
|
+
}
|
|
70
|
+
return presented;
|
|
71
|
+
}
|
|
72
|
+
export function selectSingleCredential(presented) {
|
|
73
|
+
if (presented.length === 0)
|
|
74
|
+
return { kind: "absent" };
|
|
75
|
+
if (presented.length > 1) {
|
|
76
|
+
return {
|
|
77
|
+
kind: "ambiguous",
|
|
78
|
+
error: createPlatformError("credential_ambiguous"),
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
return { kind: "single", credential: presented[0] };
|
|
82
|
+
}
|
|
83
|
+
export function selectHttpCredential(headers, options = {}) {
|
|
84
|
+
return selectSingleCredential(extractHttpCredentials(headers, options));
|
|
85
|
+
}
|
|
86
|
+
export function selectMcpCredential(headers) {
|
|
87
|
+
return selectSingleCredential(extractMcpCredentials(headers));
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Map an authentication adapter result for a transport route.
|
|
91
|
+
* Protected routes map `absent` to `unauthenticated`.
|
|
92
|
+
* `rejected` is returned unchanged (no fallback).
|
|
93
|
+
* A `system` credential from HTTP/MCP mapping becomes `internal_error`.
|
|
94
|
+
*/
|
|
95
|
+
export function mapTransportAuthentication(result, options) {
|
|
96
|
+
if (result.kind === "authenticated") {
|
|
97
|
+
if (result.credential.kind === "system") {
|
|
98
|
+
return {
|
|
99
|
+
kind: "rejected",
|
|
100
|
+
error: createPlatformError("internal_error"),
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
return result;
|
|
104
|
+
}
|
|
105
|
+
if (result.kind === "rejected") {
|
|
106
|
+
return result;
|
|
107
|
+
}
|
|
108
|
+
if (options.publicRoute)
|
|
109
|
+
return result;
|
|
110
|
+
return {
|
|
111
|
+
kind: "rejected",
|
|
112
|
+
error: createPlatformError("unauthenticated"),
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
export function createSystemCredential(credentialId) {
|
|
116
|
+
const credential = { kind: "system" };
|
|
117
|
+
if (credentialId !== undefined)
|
|
118
|
+
credential.credentialId = credentialId;
|
|
119
|
+
return credential;
|
|
120
|
+
}
|
|
121
|
+
export function isTransportCredentialKind(kind) {
|
|
122
|
+
return kind !== "system";
|
|
123
|
+
}
|
|
124
|
+
//# sourceMappingURL=credentials.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"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"}
|
package/dist/dates.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAEjD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAM7C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW1D"}
|
package/dist/dates.js
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/** UTC ISO-8601 with milliseconds. */
|
|
2
|
+
export function serializeDate(value) {
|
|
3
|
+
return value.toISOString();
|
|
4
|
+
}
|
|
5
|
+
export function parseDate(value) {
|
|
6
|
+
const parsed = new Date(value);
|
|
7
|
+
if (Number.isNaN(parsed.getTime())) {
|
|
8
|
+
throw new Error("date_invalid");
|
|
9
|
+
}
|
|
10
|
+
return parsed;
|
|
11
|
+
}
|
|
12
|
+
export function serializeDatesDeep(value) {
|
|
13
|
+
if (value instanceof Date)
|
|
14
|
+
return serializeDate(value);
|
|
15
|
+
if (Array.isArray(value))
|
|
16
|
+
return value.map(serializeDatesDeep);
|
|
17
|
+
if (value && typeof value === "object") {
|
|
18
|
+
const out = {};
|
|
19
|
+
for (const [key, nested] of Object.entries(value)) {
|
|
20
|
+
out[key] = serializeDatesDeep(nested);
|
|
21
|
+
}
|
|
22
|
+
return out;
|
|
23
|
+
}
|
|
24
|
+
return value;
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=dates.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dates.js","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,UAAU,aAAa,CAAC,KAAW;IACvC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC/D,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
|
package/dist/errors.d.ts
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
export type PlatformErrorCode = "unauthenticated" | "credential_ambiguous" | "tenant_required" | "tenant_forbidden" | "forbidden" | "not_found" | "conflict" | "validation_failed" | "rate_limited" | "internal_error";
|
|
2
|
+
export declare const PLATFORM_ERROR_CODES: readonly PlatformErrorCode[];
|
|
3
|
+
export declare const PLATFORM_ERROR_MESSAGES: Record<PlatformErrorCode, string>;
|
|
4
|
+
export declare const PLATFORM_ERROR_HTTP_STATUS: Record<PlatformErrorCode, number>;
|
|
5
|
+
export type PlatformSafeDetails = Readonly<Record<string, string | number | boolean | null>>;
|
|
6
|
+
export interface PlatformError {
|
|
7
|
+
code: PlatformErrorCode;
|
|
8
|
+
message: string;
|
|
9
|
+
safeDetails?: PlatformSafeDetails;
|
|
10
|
+
cause?: unknown;
|
|
11
|
+
}
|
|
12
|
+
export declare function isPlatformError(value: unknown): value is PlatformError;
|
|
13
|
+
export declare function createPlatformError(code: PlatformErrorCode, options?: {
|
|
14
|
+
safeDetails?: PlatformSafeDetails;
|
|
15
|
+
cause?: unknown;
|
|
16
|
+
}): PlatformError;
|
|
17
|
+
/**
|
|
18
|
+
* Thrown exceptions always become `internal_error`. The public `message` is
|
|
19
|
+
* never derived from `cause` or from a thrown PlatformError.
|
|
20
|
+
*/
|
|
21
|
+
export declare function mapThrownException(thrown: unknown): PlatformError;
|
|
22
|
+
export declare function captureAndMapException(thrown: unknown, capture?: (error: unknown) => void): PlatformError;
|
|
23
|
+
export type PublicErrorBody = {
|
|
24
|
+
code: PlatformErrorCode;
|
|
25
|
+
message: string;
|
|
26
|
+
details?: PlatformSafeDetails;
|
|
27
|
+
};
|
|
28
|
+
export type PublicHttpError = {
|
|
29
|
+
status: number;
|
|
30
|
+
body: PublicErrorBody;
|
|
31
|
+
};
|
|
32
|
+
export declare function toPublicErrorBody(error: PlatformError): PublicErrorBody;
|
|
33
|
+
export declare function toPublicHttpError(error: PlatformError): PublicHttpError;
|
|
34
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,iBAAiB,GACjB,sBAAsB,GACtB,iBAAiB,GACjB,kBAAkB,GAClB,WAAW,GACX,WAAW,GACX,UAAU,GACV,mBAAmB,GACnB,cAAc,GACd,gBAAgB,CAAC;AAErB,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAW5D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAWrE,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAWxE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CACxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CACjD,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACnE,aAAa,CAQf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAEjE;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,aAAa,CAOf;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CAOvE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CAKvE"}
|
package/dist/errors.js
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
export const PLATFORM_ERROR_CODES = [
|
|
2
|
+
"unauthenticated",
|
|
3
|
+
"credential_ambiguous",
|
|
4
|
+
"tenant_required",
|
|
5
|
+
"tenant_forbidden",
|
|
6
|
+
"forbidden",
|
|
7
|
+
"not_found",
|
|
8
|
+
"conflict",
|
|
9
|
+
"validation_failed",
|
|
10
|
+
"rate_limited",
|
|
11
|
+
"internal_error",
|
|
12
|
+
];
|
|
13
|
+
export const PLATFORM_ERROR_MESSAGES = {
|
|
14
|
+
unauthenticated: "Authentication is required.",
|
|
15
|
+
credential_ambiguous: "Exactly one credential mechanism is allowed.",
|
|
16
|
+
tenant_required: "A tenant must be selected.",
|
|
17
|
+
tenant_forbidden: "The selected tenant is not accessible.",
|
|
18
|
+
forbidden: "The requested action is not permitted.",
|
|
19
|
+
not_found: "The requested resource was not found.",
|
|
20
|
+
conflict: "The request conflicts with current state.",
|
|
21
|
+
validation_failed: "The request is invalid.",
|
|
22
|
+
rate_limited: "The request was rate limited.",
|
|
23
|
+
internal_error: "An internal error occurred.",
|
|
24
|
+
};
|
|
25
|
+
export const PLATFORM_ERROR_HTTP_STATUS = {
|
|
26
|
+
unauthenticated: 401,
|
|
27
|
+
credential_ambiguous: 400,
|
|
28
|
+
tenant_required: 400,
|
|
29
|
+
tenant_forbidden: 403,
|
|
30
|
+
forbidden: 403,
|
|
31
|
+
not_found: 404,
|
|
32
|
+
conflict: 409,
|
|
33
|
+
validation_failed: 400,
|
|
34
|
+
rate_limited: 429,
|
|
35
|
+
internal_error: 500,
|
|
36
|
+
};
|
|
37
|
+
export function isPlatformError(value) {
|
|
38
|
+
if (typeof value !== "object" || value === null)
|
|
39
|
+
return false;
|
|
40
|
+
const candidate = value;
|
|
41
|
+
return (typeof candidate.code === "string" &&
|
|
42
|
+
PLATFORM_ERROR_CODES.includes(candidate.code) &&
|
|
43
|
+
typeof candidate.message === "string");
|
|
44
|
+
}
|
|
45
|
+
export function createPlatformError(code, options = {}) {
|
|
46
|
+
const error = {
|
|
47
|
+
code,
|
|
48
|
+
message: PLATFORM_ERROR_MESSAGES[code],
|
|
49
|
+
};
|
|
50
|
+
if (options.safeDetails)
|
|
51
|
+
error.safeDetails = options.safeDetails;
|
|
52
|
+
if (options.cause !== undefined)
|
|
53
|
+
error.cause = options.cause;
|
|
54
|
+
return error;
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Thrown exceptions always become `internal_error`. The public `message` is
|
|
58
|
+
* never derived from `cause` or from a thrown PlatformError.
|
|
59
|
+
*/
|
|
60
|
+
export function mapThrownException(thrown) {
|
|
61
|
+
return createPlatformError("internal_error", { cause: thrown });
|
|
62
|
+
}
|
|
63
|
+
export function captureAndMapException(thrown, capture) {
|
|
64
|
+
try {
|
|
65
|
+
capture?.(thrown);
|
|
66
|
+
}
|
|
67
|
+
catch {
|
|
68
|
+
// Capture must not change the mapped error or fail the request.
|
|
69
|
+
}
|
|
70
|
+
return mapThrownException(thrown);
|
|
71
|
+
}
|
|
72
|
+
export function toPublicErrorBody(error) {
|
|
73
|
+
const body = {
|
|
74
|
+
code: error.code,
|
|
75
|
+
message: PLATFORM_ERROR_MESSAGES[error.code],
|
|
76
|
+
};
|
|
77
|
+
if (error.safeDetails)
|
|
78
|
+
body.details = error.safeDetails;
|
|
79
|
+
return body;
|
|
80
|
+
}
|
|
81
|
+
export function toPublicHttpError(error) {
|
|
82
|
+
return {
|
|
83
|
+
status: PLATFORM_ERROR_HTTP_STATUS[error.code],
|
|
84
|
+
body: toPublicErrorBody(error),
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
//# sourceMappingURL=errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
|
package/dist/ids.d.ts
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { Clock } from "./clock.js";
|
|
2
|
+
export type RandomBytes = (size: number) => Uint8Array;
|
|
3
|
+
/** RFC 9562 UUIDv7. Version and variant bits are always set. */
|
|
4
|
+
export declare function uuidv7(clock?: Clock, random?: RandomBytes): string;
|
|
5
|
+
export declare function uuidv7Hex(clock?: Clock, random?: RandomBytes): string;
|
|
6
|
+
export declare function createPublicId(prefix: string, clock?: Clock, random?: RandomBytes): string;
|
|
7
|
+
export declare function parsePublicId(value: string, expectedPrefix?: string): {
|
|
8
|
+
prefix: string;
|
|
9
|
+
uuidHex: string;
|
|
10
|
+
};
|
|
11
|
+
export declare function createRequestId(clock?: Clock, random?: RandomBytes): string;
|
|
12
|
+
export declare function readOrCreateRequestId(header: string | undefined, clock?: Clock, random?: RandomBytes): string;
|
|
13
|
+
//# sourceMappingURL=ids.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;AAcvD,gEAAgE;AAChE,wBAAgB,MAAM,CACpB,KAAK,GAAE,KAAmB,EAC1B,MAAM,GAAE,WAA2B,GAClC,MAAM,CAgBR;AAED,wBAAgB,SAAS,CACvB,KAAK,GAAE,KAAmB,EAC1B,MAAM,GAAE,WAA2B,GAClC,MAAM,CAER;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,KAAmB,EAC1B,MAAM,GAAE,WAA2B,GAClC,MAAM,CAKR;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAcrC;AAED,wBAAgB,eAAe,CAC7B,KAAK,GAAE,KAAmB,EAC1B,MAAM,GAAE,WAA2B,GAClC,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,GAAE,KAAmB,EAC1B,MAAM,GAAE,WAA2B,GAClC,MAAM,CAKR"}
|
package/dist/ids.js
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { systemClock } from "./clock.js";
|
|
2
|
+
const UUID_HEX = /^[0-9a-f]{32}$/;
|
|
3
|
+
const PREFIX = /^[a-z][a-z0-9]{0,15}$/;
|
|
4
|
+
const defaultRandom = (size) => crypto.getRandomValues(new Uint8Array(size));
|
|
5
|
+
function byteToHex(byte) {
|
|
6
|
+
return byte.toString(16).padStart(2, "0");
|
|
7
|
+
}
|
|
8
|
+
function bytesToUuid(bytes) {
|
|
9
|
+
const hex = Array.from(bytes, byteToHex).join("");
|
|
10
|
+
return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
|
|
11
|
+
}
|
|
12
|
+
/** RFC 9562 UUIDv7. Version and variant bits are always set. */
|
|
13
|
+
export function uuidv7(clock = systemClock, random = defaultRandom) {
|
|
14
|
+
const bytes = random(16);
|
|
15
|
+
if (bytes.length < 16) {
|
|
16
|
+
throw new Error("random_bytes_short");
|
|
17
|
+
}
|
|
18
|
+
const timestamp = BigInt(clock.now().getTime());
|
|
19
|
+
bytes[0] = Number((timestamp >> 40n) & 0xffn);
|
|
20
|
+
bytes[1] = Number((timestamp >> 32n) & 0xffn);
|
|
21
|
+
bytes[2] = Number((timestamp >> 24n) & 0xffn);
|
|
22
|
+
bytes[3] = Number((timestamp >> 16n) & 0xffn);
|
|
23
|
+
bytes[4] = Number((timestamp >> 8n) & 0xffn);
|
|
24
|
+
bytes[5] = Number(timestamp & 0xffn);
|
|
25
|
+
bytes[6] = (bytes[6] & 0x0f) | 0x70;
|
|
26
|
+
bytes[7] = bytes[7];
|
|
27
|
+
bytes[8] = (bytes[8] & 0x3f) | 0x80;
|
|
28
|
+
return bytesToUuid(bytes);
|
|
29
|
+
}
|
|
30
|
+
export function uuidv7Hex(clock = systemClock, random = defaultRandom) {
|
|
31
|
+
return uuidv7(clock, random).replaceAll("-", "");
|
|
32
|
+
}
|
|
33
|
+
export function createPublicId(prefix, clock = systemClock, random = defaultRandom) {
|
|
34
|
+
if (!PREFIX.test(prefix)) {
|
|
35
|
+
throw new Error("public_id_prefix_invalid");
|
|
36
|
+
}
|
|
37
|
+
return `${prefix}_${uuidv7Hex(clock, random)}`;
|
|
38
|
+
}
|
|
39
|
+
export function parsePublicId(value, expectedPrefix) {
|
|
40
|
+
const sep = value.indexOf("_");
|
|
41
|
+
if (sep <= 0) {
|
|
42
|
+
throw new Error("public_id_invalid");
|
|
43
|
+
}
|
|
44
|
+
const prefix = value.slice(0, sep);
|
|
45
|
+
const uuidHex = value.slice(sep + 1);
|
|
46
|
+
if (!PREFIX.test(prefix) || !UUID_HEX.test(uuidHex)) {
|
|
47
|
+
throw new Error("public_id_invalid");
|
|
48
|
+
}
|
|
49
|
+
if (expectedPrefix !== undefined && prefix !== expectedPrefix) {
|
|
50
|
+
throw new Error("public_id_prefix_mismatch");
|
|
51
|
+
}
|
|
52
|
+
return { prefix, uuidHex };
|
|
53
|
+
}
|
|
54
|
+
export function createRequestId(clock = systemClock, random = defaultRandom) {
|
|
55
|
+
return uuidv7(clock, random);
|
|
56
|
+
}
|
|
57
|
+
export function readOrCreateRequestId(header, clock = systemClock, random = defaultRandom) {
|
|
58
|
+
if (typeof header === "string" && header.trim().length > 0) {
|
|
59
|
+
return header.trim().slice(0, 128);
|
|
60
|
+
}
|
|
61
|
+
return createRequestId(clock, random);
|
|
62
|
+
}
|
|
63
|
+
//# sourceMappingURL=ids.js.map
|
package/dist/ids.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export { type Clock, frozenClock, systemClock } from "./clock.js";
|
|
2
|
+
export { type CredentialSelection, createSystemCredential, DEFAULT_SESSION_COOKIE_NAME, extractHttpCredentials, extractMcpCredentials, type HeaderMap, isTransportCredentialKind, mapTransportAuthentication, type PresentedCredential, selectHttpCredential, selectMcpCredential, selectSingleCredential, type TransportCredentialKind, } from "./credentials.js";
|
|
3
|
+
export { parseDate, serializeDate, serializeDatesDeep } from "./dates.js";
|
|
4
|
+
export { captureAndMapException, createPlatformError, isPlatformError, mapThrownException, PLATFORM_ERROR_CODES, PLATFORM_ERROR_HTTP_STATUS, PLATFORM_ERROR_MESSAGES, type PlatformError, type PlatformErrorCode, type PlatformSafeDetails, type PublicErrorBody, type PublicHttpError, toPublicErrorBody, toPublicHttpError, } from "./errors.js";
|
|
5
|
+
export { createPublicId, createRequestId, parsePublicId, type RandomBytes, readOrCreateRequestId, uuidv7, uuidv7Hex, } from "./ids.js";
|
|
6
|
+
export { createGracefulShutdown, type GracefulShutdown, type HealthReport, healthReport, type ReadinessCheck, type ReadinessReport, readinessReport, type ShutdownHook, } from "./lifecycle.js";
|
|
7
|
+
export type { AuditPort, AuthenticationAdapter, AuthenticationResult, AuthorizationAdapter, CredentialKind, PlatformCredential, PlatformRequestContext, TenantContextAdapter, TransportName, } from "./types.js";
|
|
8
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EACL,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,SAAS,EACd,yBAAyB,EACzB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,KAAK,WAAW,EAChB,qBAAqB,EACrB,MAAM,EACN,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,eAAe,EACf,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export { frozenClock, systemClock } from "./clock.js";
|
|
2
|
+
export { createSystemCredential, DEFAULT_SESSION_COOKIE_NAME, extractHttpCredentials, extractMcpCredentials, isTransportCredentialKind, mapTransportAuthentication, selectHttpCredential, selectMcpCredential, selectSingleCredential, } from "./credentials.js";
|
|
3
|
+
export { parseDate, serializeDate, serializeDatesDeep } from "./dates.js";
|
|
4
|
+
export { captureAndMapException, createPlatformError, isPlatformError, mapThrownException, PLATFORM_ERROR_CODES, PLATFORM_ERROR_HTTP_STATUS, PLATFORM_ERROR_MESSAGES, toPublicErrorBody, toPublicHttpError, } from "./errors.js";
|
|
5
|
+
export { createPublicId, createRequestId, parsePublicId, readOrCreateRequestId, uuidv7, uuidv7Hex, } from "./ids.js";
|
|
6
|
+
export { createGracefulShutdown, healthReport, readinessReport, } from "./lifecycle.js";
|
|
7
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAEL,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EAErB,yBAAyB,EACzB,0BAA0B,EAE1B,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GAEvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EAMvB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EAEb,qBAAqB,EACrB,MAAM,EACN,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,sBAAsB,EAGtB,YAAY,EAGZ,eAAe,GAEhB,MAAM,gBAAgB,CAAC"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { Clock } from "./clock.js";
|
|
2
|
+
export type HealthReport = {
|
|
3
|
+
status: "ok";
|
|
4
|
+
service: string;
|
|
5
|
+
time: string;
|
|
6
|
+
};
|
|
7
|
+
export type ReadinessCheck = {
|
|
8
|
+
name: string;
|
|
9
|
+
ready: boolean;
|
|
10
|
+
};
|
|
11
|
+
export type ReadinessReport = {
|
|
12
|
+
status: "ready" | "not_ready";
|
|
13
|
+
checks: Record<string, boolean>;
|
|
14
|
+
};
|
|
15
|
+
export declare function healthReport(service: string, clock?: Clock): HealthReport;
|
|
16
|
+
export declare function readinessReport(checks: readonly ReadinessCheck[]): ReadinessReport;
|
|
17
|
+
export type ShutdownHook = () => Promise<void> | void;
|
|
18
|
+
export type GracefulShutdown = {
|
|
19
|
+
shuttingDown: () => boolean;
|
|
20
|
+
shutdown: () => Promise<void>;
|
|
21
|
+
};
|
|
22
|
+
export declare function createGracefulShutdown(options: {
|
|
23
|
+
timeoutMs: number;
|
|
24
|
+
hooks: readonly ShutdownHook[];
|
|
25
|
+
}): GracefulShutdown;
|
|
26
|
+
//# sourceMappingURL=lifecycle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,KAAmB,GACzB,YAAY,CAMd;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,eAAe,CAQlF;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CAChC,GAAG,gBAAgB,CA6BnB"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { systemClock } from "./clock.js";
|
|
2
|
+
import { serializeDate } from "./dates.js";
|
|
3
|
+
export function healthReport(service, clock = systemClock) {
|
|
4
|
+
return {
|
|
5
|
+
status: "ok",
|
|
6
|
+
service,
|
|
7
|
+
time: serializeDate(clock.now()),
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
export function readinessReport(checks) {
|
|
11
|
+
const mapped = {};
|
|
12
|
+
let ready = true;
|
|
13
|
+
for (const check of checks) {
|
|
14
|
+
mapped[check.name] = check.ready;
|
|
15
|
+
if (!check.ready)
|
|
16
|
+
ready = false;
|
|
17
|
+
}
|
|
18
|
+
return { status: ready ? "ready" : "not_ready", checks: mapped };
|
|
19
|
+
}
|
|
20
|
+
export function createGracefulShutdown(options) {
|
|
21
|
+
let shuttingDown = false;
|
|
22
|
+
let inFlight;
|
|
23
|
+
return {
|
|
24
|
+
shuttingDown: () => shuttingDown,
|
|
25
|
+
async shutdown() {
|
|
26
|
+
if (inFlight)
|
|
27
|
+
return inFlight;
|
|
28
|
+
shuttingDown = true;
|
|
29
|
+
inFlight = (async () => {
|
|
30
|
+
const work = Promise.all(options.hooks.map(async (hook) => {
|
|
31
|
+
await hook();
|
|
32
|
+
}));
|
|
33
|
+
let timer;
|
|
34
|
+
const timeout = new Promise((_, reject) => {
|
|
35
|
+
timer = setTimeout(() => {
|
|
36
|
+
reject(new Error("shutdown_timeout"));
|
|
37
|
+
}, options.timeoutMs);
|
|
38
|
+
});
|
|
39
|
+
try {
|
|
40
|
+
await Promise.race([work, timeout]);
|
|
41
|
+
}
|
|
42
|
+
finally {
|
|
43
|
+
if (timer)
|
|
44
|
+
clearTimeout(timer);
|
|
45
|
+
}
|
|
46
|
+
})();
|
|
47
|
+
return inFlight;
|
|
48
|
+
},
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=lifecycle.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkB3C,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,QAAe,WAAW;IAE1B,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,OAAO;QACP,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAiC;IAC/D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACnE,CAAC;AASD,MAAM,UAAU,sBAAsB,CAAC,OAGtC;IACC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,QAAmC,CAAC;IACxC,OAAO;QACL,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY;QAChC,KAAK,CAAC,QAAQ;YACZ,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC9B,YAAY,GAAG,IAAI,CAAC;YACpB,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;gBACrB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CACtB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;oBAC/B,MAAM,IAAI,EAAE,CAAC;gBACf,CAAC,CAAC,CACH,CAAC;gBACF,IAAI,KAAgD,CAAC;gBACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;wBACtB,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;oBACxC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;gBACtC,CAAC;wBAAS,CAAC;oBACT,IAAI,KAAK;wBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YACL,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { PlatformError } from "./errors.js";
|
|
2
|
+
export type CredentialKind = "session" | "oauth" | "api_key" | "system";
|
|
3
|
+
export interface PlatformCredential {
|
|
4
|
+
kind: CredentialKind;
|
|
5
|
+
credentialId?: string;
|
|
6
|
+
}
|
|
7
|
+
export interface PlatformRequestContext<PrincipalId extends string, TenantId extends string, Permission extends string> {
|
|
8
|
+
requestId: string;
|
|
9
|
+
principalId: PrincipalId;
|
|
10
|
+
tenantId: TenantId | null;
|
|
11
|
+
credential: PlatformCredential;
|
|
12
|
+
permissions: ReadonlySet<Permission>;
|
|
13
|
+
}
|
|
14
|
+
export type AuthenticationResult<PrincipalId extends string> = {
|
|
15
|
+
kind: "authenticated";
|
|
16
|
+
principalId: PrincipalId;
|
|
17
|
+
credential: PlatformCredential;
|
|
18
|
+
} | {
|
|
19
|
+
kind: "absent";
|
|
20
|
+
} | {
|
|
21
|
+
kind: "rejected";
|
|
22
|
+
error: PlatformError;
|
|
23
|
+
};
|
|
24
|
+
export interface AuthenticationAdapter<Request, PrincipalId extends string> {
|
|
25
|
+
authenticate(request: Request): Promise<AuthenticationResult<PrincipalId>>;
|
|
26
|
+
}
|
|
27
|
+
export interface TenantContextAdapter<PrincipalId extends string, TenantId extends string, Permission extends string> {
|
|
28
|
+
resolve(input: {
|
|
29
|
+
principalId: PrincipalId;
|
|
30
|
+
credential: CredentialKind;
|
|
31
|
+
requestedTenantId: TenantId | null;
|
|
32
|
+
}): Promise<{
|
|
33
|
+
tenantId: TenantId | null;
|
|
34
|
+
permissions: ReadonlySet<Permission>;
|
|
35
|
+
}>;
|
|
36
|
+
}
|
|
37
|
+
export interface AuthorizationAdapter<Context, Action extends string, Resource> {
|
|
38
|
+
authorize(input: {
|
|
39
|
+
context: Context;
|
|
40
|
+
action: Action;
|
|
41
|
+
resource: Resource;
|
|
42
|
+
}): Promise<{
|
|
43
|
+
allowed: true;
|
|
44
|
+
} | {
|
|
45
|
+
allowed: false;
|
|
46
|
+
error: PlatformError;
|
|
47
|
+
}>;
|
|
48
|
+
}
|
|
49
|
+
export interface AuditPort<Context, Event> {
|
|
50
|
+
record(context: Context, event: Event): Promise<void>;
|
|
51
|
+
}
|
|
52
|
+
export type TransportName = "http" | "mcp";
|
|
53
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB,CACrC,WAAW,SAAS,MAAM,EAC1B,QAAQ,SAAS,MAAM,EACvB,UAAU,SAAS,MAAM;IAEzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,oBAAoB,CAAC,WAAW,SAAS,MAAM,IACvD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,kBAAkB,CAAC;CAChC,GACD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE/C,MAAM,WAAW,qBAAqB,CAAC,OAAO,EAAE,WAAW,SAAS,MAAM;IACxE,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,oBAAoB,CACnC,WAAW,SAAS,MAAM,EAC1B,QAAQ,SAAS,MAAM,EACvB,UAAU,SAAS,MAAM;IAEzB,OAAO,CAAC,KAAK,EAAE;QACb,WAAW,EAAE,WAAW,CAAC;QACzB,UAAU,EAAE,cAAc,CAAC;QAC3B,iBAAiB,EAAE,QAAQ,GAAG,IAAI,CAAC;KACpC,GAAG,OAAO,CAAC;QACV,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC1B,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;KACtC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,EAAE,MAAM,SAAS,MAAM,EAAE,QAAQ;IAC5E,SAAS,CAAC,KAAK,EAAE;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,QAAQ,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,SAAS,CAAC,OAAO,EAAE,KAAK;IACvC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
|
package/package.json
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@codelitdev/platform",
|
|
3
|
+
"version": "0.1.0-alpha.0",
|
|
4
|
+
"description": "Composition kernel for CodeLit Platform products",
|
|
5
|
+
"author": "CodeLit",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"license": "MIT",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/codelitdev/platform.git",
|
|
11
|
+
"directory": "packages/platform"
|
|
12
|
+
},
|
|
13
|
+
"homepage": "https://github.com/codelitdev/platform/tree/main/packages/platform#readme",
|
|
14
|
+
"bugs": {
|
|
15
|
+
"url": "https://github.com/codelitdev/platform/issues"
|
|
16
|
+
},
|
|
17
|
+
"exports": {
|
|
18
|
+
".": {
|
|
19
|
+
"types": "./dist/index.d.ts",
|
|
20
|
+
"import": "./dist/index.js",
|
|
21
|
+
"default": "./dist/index.js"
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
"files": [
|
|
25
|
+
"dist"
|
|
26
|
+
],
|
|
27
|
+
"scripts": {
|
|
28
|
+
"build": "tsc -p tsconfig.json",
|
|
29
|
+
"test": "bun test --timeout 60000 src",
|
|
30
|
+
"test:watch": "bun test --watch --timeout 60000 src",
|
|
31
|
+
"test:packed": "bun scripts/packed-consumer.mjs",
|
|
32
|
+
"typecheck": "tsc -p tsconfig.test.json --noEmit",
|
|
33
|
+
"lint": "biome lint .",
|
|
34
|
+
"prepublishOnly": "bun run build"
|
|
35
|
+
},
|
|
36
|
+
"publishConfig": {
|
|
37
|
+
"access": "public",
|
|
38
|
+
"tag": "latest"
|
|
39
|
+
},
|
|
40
|
+
"devDependencies": {
|
|
41
|
+
"@types/bun": "^1.4.1",
|
|
42
|
+
"@types/node": "^22.14.1",
|
|
43
|
+
"typescript": "^5.9.3"
|
|
44
|
+
}
|
|
45
|
+
}
|