@starci/eslint-canon-be 3.11.19 → 3.13.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/CHANGELOG.md +11 -0
- package/README.md +10 -0
- package/dist/auth-passport.d.ts +2 -4
- package/dist/auth-passport.js +21 -33
- package/dist/explicit-surface.d.ts +7 -0
- package/dist/explicit-surface.js +19 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.js +3 -1
- package/dist/lib/unit-spec.js +2 -2
- package/dist/project-graph.d.ts +14 -0
- package/dist/project-graph.js +16 -1
- package/package.json +1 -1
- package/runtime/bundle.json +2 -0
- package/runtime/knowledge/hfs/canon-pins.yaml +31 -10
- package/runtime/knowledge/hfs/fe-stack.yaml +7 -7
- package/runtime/knowledge/hfs/rules.yaml +107 -8
- package/runtime/knowledge/hfs/slots.yaml +71 -22
- package/runtime/scripts/hfs/architecture/identity.mjs +18 -83
- package/runtime/scripts/hfs/architecture/test-world-files.mjs +26 -7
- package/runtime/scripts/hfs/architecture/transport-owner.mjs +3 -6
- package/runtime/scripts/hfs/explicit-surface-rule.mjs +59 -0
- package/runtime/scripts/hfs/manifest-shape.mjs +1 -1
- package/runtime/scripts/hfs/slots.mjs +1 -1
- package/runtime/scripts/lib/declaration-surface.mjs +112 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,16 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 3.13.0 - 2026-11-03
|
|
4
|
+
|
|
5
|
+
- Changed: the runtime copies of the slot manifest carry the managed sign-in slots and the slot field `managedOnly`.
|
|
6
|
+
- Changed: `own-jwks-only` refuses `jwtVerify`, `decodeJwt`, `decodeProtectedHeader` and `createRemoteJWKSet` of jose in every app file; `refresh-token-cookie-only` no longer exempts `integrations/passport` (the package sets the cookie); the infrastructure table owns the identity libraries by nobody and `@starci/auth` by `integrations/passport` (R328, R329, R330).
|
|
7
|
+
|
|
8
|
+
## 3.12.0
|
|
9
|
+
|
|
10
|
+
- Added: `starci-be/explicit-export-surface` (R368, `HFS_EXPLICIT_EXPORT_SURFACE`) at error: an exported function's return type, an exported variable's type and a parameter's type are written, not inferred from a body or from other files. It reports each export the isolated declaration emit cannot write, at the offending span, and says what to annotate. It reads the classifier the lint result cache reads.
|
|
11
|
+
- Added: `projectGraphSnapshot`, the findings of the project graph the process has already built, which the ESLint child hands to the cache; `projectGraph` stays the fresh build.
|
|
12
|
+
- Changed: carry the bundled runtime of @starci/hfs 5.1.0 (the classifier, the rule factory, the rule catalog with R368, the canon pins).
|
|
13
|
+
|
|
3
14
|
## 3.11.19
|
|
4
15
|
|
|
5
16
|
- Changed: Carry the bundled runtime of @starci/hfs 5.0.8 (the rule texts name `app check`, the read-set helper of the rule memo) and its canon pins; the comments name `app check` for the removed lint verb.
|
package/README.md
CHANGED
|
@@ -155,6 +155,16 @@ in `src/lib/hfs-view.ts`, which is emitted, so the published declarations of `lo
|
|
|
155
155
|
untyped runtime file. `fixtures/` is spec data and stays JavaScript with
|
|
156
156
|
`.d.mts` contracts, because the front-end canon and the Grammar lint families import its helpers by path.
|
|
157
157
|
|
|
158
|
+
The [explicit exported surface](../../contexts/code/shared/typing.md) (R368, SHARED-TYPING-5) is `explicit-export-surface`
|
|
159
|
+
(`HFS_EXPLICIT_EXPORT_SURFACE`): an exported function's return type, an exported variable's type and a parameter's type are
|
|
160
|
+
written where they are exported, never inferred from a body or from other files; a component that returns only JSX, `null` or
|
|
161
|
+
`undefined` is explicit. It reports each export TypeScript's isolated declaration emit cannot write, at the offending span, and says
|
|
162
|
+
which annotation to add. It reads the classifier the lint result cache reads (`declarationSurface`, the bundled
|
|
163
|
+
`runtime/scripts/lib/declaration-surface.mjs`), so it reports exactly the files the cache counts as open.
|
|
164
|
+
|
|
165
|
+
`projectGraph` and `projectGraphSnapshot` are the cache's two readers of the project graph the graph rules share: the first builds it
|
|
166
|
+
afresh, the second answers from the graph the process has already built, which is how the ESLint child hands its graph to the cache.
|
|
167
|
+
|
|
158
168
|
## HFS rules and their why codes
|
|
159
169
|
|
|
160
170
|
Every rule of this plugin is an enforcer of one HFS rule. The relation (rule id -> HFS rule -> catalogued Vietnamese why code)
|
package/dist/auth-passport.d.ts
CHANGED
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
import type { Recommended, RuleModule } from "./lib/rule.js";
|
|
2
|
-
/**
|
|
3
|
-
export declare const PASSPORT_OWNER = "integrations/passport";
|
|
4
|
-
/** A lite principal comes only from the app's own verified token. */
|
|
2
|
+
/** A lite principal comes only from the app's own token, verified by the package. */
|
|
5
3
|
export declare const ownJwksOnly: RuleModule;
|
|
6
|
-
/** A refresh token lives only in the
|
|
4
|
+
/** A refresh token lives only in the package's httpOnly cookie. */
|
|
7
5
|
export declare const refreshTokenCookieOnly: RuleModule;
|
|
8
6
|
/** The rules of the lite identity law, by name. */
|
|
9
7
|
export declare const rules: {
|
package/dist/auth-passport.js
CHANGED
|
@@ -1,44 +1,36 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The rules of the lite identity (catalog R329 `BE_AUTH_JWT_OWN_JWKS`, R330 `BE_AUTH_REFRESH_COOKIE`; contexts/code/be/api-auth.md
|
|
3
3
|
* BE-AUTH-2 and BE-AUTH-3). Which owner may import the identity and S3 libraries at all is the infrastructure table of the slot
|
|
4
|
-
* manifest (`ruleParams.be.infraOwners`, judged by `infra-import-owner`: R328 `BE_AUTH_PASSPORT_OWNER`, R331 `BE_STORAGE_OWNER`)
|
|
4
|
+
* manifest (`ruleParams.be.infraOwners`, judged by `infra-import-owner`: R328 `BE_AUTH_PASSPORT_OWNER`, R331 `BE_STORAGE_OWNER`): the
|
|
5
|
+
* identity libraries belong to `@starci/auth` and to no app file, and `@starci/auth` itself only to `integrations/passport`.
|
|
5
6
|
*
|
|
6
|
-
* - `own-jwks-only`: the app verifies
|
|
7
|
-
* `
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
* refresh cookie: the cookie is set, rotated and cleared only by the integration's `setRefreshCookie`/`clearRefreshCookie`.
|
|
13
|
-
* Its attributes (httpOnly, Secure, SameSite=Strict, the refresh path) are `response-cookie-attributes` (R141) and the
|
|
14
|
-
* integration's own spec; rotation with reuse detection is held by the identity domain's spec and review.
|
|
7
|
+
* - `own-jwks-only`: the app verifies no token itself. `createRemoteJWKSet` (a remote identity provider's key set), `decodeJwt`,
|
|
8
|
+
* `decodeProtectedHeader` (a token read without its signature) and `jwtVerify` are refused wherever jose is imported; the package
|
|
9
|
+
* verifies against its own key set. The architecture machine (`own-jwks-principal`) proves the same on the call sites.
|
|
10
|
+
* - `refresh-token-cookie-only`: a refresh token never travels in a body. No object literal, class property or type member is
|
|
11
|
+
* named `refreshToken` or `refresh_token`, and no `.cookie()`/`.clearCookie()` call names a refresh cookie: `@starci/auth` sets,
|
|
12
|
+
* rotates and clears it. Its attributes and rotation with reuse detection are the package's own specs.
|
|
15
13
|
*/
|
|
16
14
|
import { keyName, staticText } from "./lib/ast.js";
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
export const PASSPORT_OWNER = "integrations/passport";
|
|
20
|
-
/** The jose exports no file uses: a remote key set and the unverified decoders. */
|
|
21
|
-
const FORBIDDEN_JOSE = new Set(["createRemoteJWKSet", "decodeJwt", "decodeProtectedHeader"]);
|
|
15
|
+
/** The jose exports no app file uses: a remote key set, the unverified decoders and the verifier itself. */
|
|
16
|
+
const FORBIDDEN_JOSE = new Set(["createRemoteJWKSet", "decodeJwt", "decodeProtectedHeader", "jwtVerify"]);
|
|
22
17
|
const REFRESH_NAME = /^refresh_?token$/i;
|
|
23
18
|
const REFRESH_COOKIE = /refresh/i;
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
return root === null ? null : root.split("/").slice(-2).join("/");
|
|
19
|
+
const WHY = {
|
|
20
|
+
createRemoteJWKSet: "trusts another issuer's key set",
|
|
21
|
+
jwtVerify: "verifies a token in the app",
|
|
28
22
|
};
|
|
29
|
-
/** A lite principal comes only from the app's own verified
|
|
23
|
+
/** A lite principal comes only from the app's own token, verified by the package. */
|
|
30
24
|
export const ownJwksOnly = {
|
|
31
25
|
meta: {
|
|
32
26
|
type: "problem",
|
|
33
|
-
docs: { description: "
|
|
27
|
+
docs: { description: "No app file verifies or decodes a token with jose: `@starci/auth` verifies the app's own access tokens against its own key set." },
|
|
34
28
|
schema: [],
|
|
35
29
|
messages: {
|
|
36
|
-
forbidden: "`{{name}}` of jose {{why}}. The app verifies only its own access tokens
|
|
37
|
-
verifier: "`jwtVerify` is imported outside `integrations/passport`. Verify a token through the integration's verifier (`OWN_TOKEN_VERIFIER`), which domain/identity turns into the principal.",
|
|
30
|
+
forbidden: "`{{name}}` of jose {{why}}. The app verifies only its own access tokens, and `@starci/auth` does it (the verifier of `integrations/passport`, `OWN_TOKEN_VERIFIER`, which `domain/identity` turns into the principal).",
|
|
38
31
|
},
|
|
39
32
|
},
|
|
40
33
|
create(context) {
|
|
41
|
-
const owner = ownerIdOf(context, context.filename) === PASSPORT_OWNER;
|
|
42
34
|
return {
|
|
43
35
|
ImportDeclaration(node) {
|
|
44
36
|
if (node.source.value !== "jose")
|
|
@@ -48,29 +40,25 @@ export const ownJwksOnly = {
|
|
|
48
40
|
continue;
|
|
49
41
|
const name = keyName(specifier.imported);
|
|
50
42
|
if (name !== null && FORBIDDEN_JOSE.has(name)) {
|
|
51
|
-
context.report({ node: specifier, messageId: "forbidden", data: { name, why: name
|
|
43
|
+
context.report({ node: specifier, messageId: "forbidden", data: { name, why: WHY[name] ?? "reads a token without proving its signature" } });
|
|
52
44
|
}
|
|
53
|
-
else if (name === "jwtVerify" && !owner)
|
|
54
|
-
context.report({ node: specifier, messageId: "verifier" });
|
|
55
45
|
}
|
|
56
46
|
},
|
|
57
47
|
};
|
|
58
48
|
},
|
|
59
49
|
};
|
|
60
|
-
/** A refresh token lives only in the
|
|
50
|
+
/** A refresh token lives only in the package's httpOnly cookie. */
|
|
61
51
|
export const refreshTokenCookieOnly = {
|
|
62
52
|
meta: {
|
|
63
53
|
type: "problem",
|
|
64
|
-
docs: { description: "A refresh token never appears as a body field, and
|
|
54
|
+
docs: { description: "A refresh token never appears as a body field, and no app file sets or clears the refresh cookie: `@starci/auth` does." },
|
|
65
55
|
schema: [],
|
|
66
56
|
messages: {
|
|
67
|
-
field: "`{{name}}` carries a refresh token in a body. The refresh token lives only in the httpOnly, Secure
|
|
68
|
-
cookie: "`{{call}}` names the refresh cookie
|
|
57
|
+
field: "`{{name}}` carries a refresh token in a body. The refresh token lives only in the httpOnly, Secure cookie that `@starci/auth` sets, rotates and clears.",
|
|
58
|
+
cookie: "`{{call}}` names the refresh cookie in the app. `@starci/auth` sets and clears it through `AuthDoors`; the app never writes it.",
|
|
69
59
|
},
|
|
70
60
|
},
|
|
71
61
|
create(context) {
|
|
72
|
-
if (ownerIdOf(context, context.filename) === PASSPORT_OWNER)
|
|
73
|
-
return {};
|
|
74
62
|
const field = (node, key, computed) => {
|
|
75
63
|
const name = computed ? null : keyName(key);
|
|
76
64
|
if (name !== null && REFRESH_NAME.test(name))
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { Recommended, RuleModule } from "./lib/rule.js";
|
|
2
|
+
/** The rules this law contributes to the plugin. */
|
|
3
|
+
export declare const rules: {
|
|
4
|
+
"explicit-export-surface": RuleModule;
|
|
5
|
+
};
|
|
6
|
+
/** Every exported type is written out, at error. */
|
|
7
|
+
export declare const recommended: Recommended;
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The explicit exported surface (HFS R368, `HFS_EXPLICIT_EXPORT_SURFACE`): an exported declaration states its type, in the file that exports it.
|
|
3
|
+
*
|
|
4
|
+
* A return type, variable type or parameter type left to inference is a surface importers read from the body and from the files the body uses, so
|
|
5
|
+
* the result cache of `starci app check --gate lint` lints every importer again whenever the file changes (check-cache.md, ESLint). The rule
|
|
6
|
+
* reports each export the isolated declaration emit (`ts.transpileDeclaration`) cannot write without inference, where it is written, and says
|
|
7
|
+
* what to annotate. A component that returns only JSX has the type the JSX namespace gives it and is not reported. It is the very classifier the
|
|
8
|
+
* cache reads (`declarationSurface` of the bundled runtime), so the rule reports exactly the files the cache counts as open.
|
|
9
|
+
*/
|
|
10
|
+
import ts from "typescript";
|
|
11
|
+
import { explicitSurfaceRule } from "../runtime/scripts/hfs/explicit-surface-rule.mjs";
|
|
12
|
+
/** The rules this law contributes to the plugin. */
|
|
13
|
+
export const rules = {
|
|
14
|
+
"explicit-export-surface": explicitSurfaceRule({ ts }),
|
|
15
|
+
};
|
|
16
|
+
/** Every exported type is written out, at error. */
|
|
17
|
+
export const recommended = {
|
|
18
|
+
"starci-be/explicit-export-surface": "error",
|
|
19
|
+
};
|
package/dist/index.d.ts
CHANGED
|
@@ -54,5 +54,5 @@ export { linterOptions } from "./lib/config.js";
|
|
|
54
54
|
export { loadHfs } from "./lib/hfs.js";
|
|
55
55
|
export { crossFileInputs } from "./lib/cross-file-inputs.js";
|
|
56
56
|
export type { CrossFileInput } from "./lib/cross-file-inputs.js";
|
|
57
|
-
export { projectGraph } from "./project-graph.js";
|
|
57
|
+
export { projectGraph, projectGraphSnapshot } from "./project-graph.js";
|
|
58
58
|
export type { ProjectGraphFinding, ProjectGraphSnapshot } from "./project-graph.js";
|
package/dist/index.js
CHANGED
|
@@ -61,6 +61,7 @@ import { recommended as serviceIsolationRecommended, rules as serviceIsolationRu
|
|
|
61
61
|
import { recommended as sizeBudgetRecommended, rules as sizeBudgetRules } from "./size-budget.js";
|
|
62
62
|
import { recommended as specNoSkipRecommended, rules as specNoSkipRules } from "./spec-no-skip.js";
|
|
63
63
|
import { recommended as specQualityRecommended, rules as specQualityRules } from "./spec-quality.js";
|
|
64
|
+
import { recommended as explicitSurfaceRecommended, rules as explicitSurfaceRules } from "./explicit-surface.js";
|
|
64
65
|
import { recommended as suppressionRecommended, rules as suppressionRules } from "./suppression.js";
|
|
65
66
|
import { recommended as temporalRecommended, rules as temporalRules } from "./temporal.js";
|
|
66
67
|
import { recommended as testingRecommended, rules as testingRules } from "./testing.js";
|
|
@@ -121,6 +122,7 @@ const CONTRIBUTIONS = [
|
|
|
121
122
|
{ law: "size-budget", rules: sizeBudgetRules, recommended: sizeBudgetRecommended },
|
|
122
123
|
{ law: "spec-no-skip", rules: specNoSkipRules, recommended: specNoSkipRecommended },
|
|
123
124
|
{ law: "spec-quality", rules: specQualityRules, recommended: specQualityRecommended },
|
|
125
|
+
{ law: "explicit-surface", rules: explicitSurfaceRules, recommended: explicitSurfaceRecommended },
|
|
124
126
|
{ law: "suppression", rules: suppressionRules, recommended: suppressionRecommended },
|
|
125
127
|
{ law: "temporal", rules: temporalRules, recommended: temporalRecommended },
|
|
126
128
|
{ law: "testing", rules: testingRules, recommended: testingRecommended },
|
|
@@ -220,4 +222,4 @@ for (const entry of [
|
|
|
220
222
|
}
|
|
221
223
|
// The result cache of `starci app check --gate lint` (contexts/project/check-cache.md) reads these two declarations of the installed canon.
|
|
222
224
|
export { crossFileInputs } from "./lib/cross-file-inputs.js";
|
|
223
|
-
export { projectGraph } from "./project-graph.js";
|
|
225
|
+
export { projectGraph, projectGraphSnapshot } from "./project-graph.js";
|
package/dist/lib/unit-spec.js
CHANGED
|
@@ -49,8 +49,8 @@ const inRoleSlot = (hfs, role, filename) => (role.optional === true ? inCoverage
|
|
|
49
49
|
/** The path of a classified file below the instance root of its slot. */
|
|
50
50
|
const slotRelative = (found) => (found.root !== undefined && found.path.startsWith(`${found.root}/`) ? found.path.slice(found.root.length + 1) : baseOf(found.path));
|
|
51
51
|
/**
|
|
52
|
-
* The optional spec role of a spec beside a logic file its slot declares (`logic`): `passport.
|
|
53
|
-
* `passport.
|
|
52
|
+
* The optional spec role of a spec beside a logic file its slot declares (`logic`): `passport.kit.spec.ts` beside the declared
|
|
53
|
+
* `passport.kit.ts` gives `{ role: "kit", spec: "kit.spec" }`, so the subject resolves as a logic role's does. It holds for that
|
|
54
54
|
* one declared file only, never for another `*.tokens.ts`, and adds no role name to the manifest.
|
|
55
55
|
*/
|
|
56
56
|
const declaredLogicRole = (hfs, filename) => {
|
package/dist/project-graph.d.ts
CHANGED
|
@@ -34,3 +34,17 @@ export declare const projectGraph: ({ repoRoot, injectedTypeScript }: {
|
|
|
34
34
|
repoRoot: string;
|
|
35
35
|
injectedTypeScript?: object;
|
|
36
36
|
}) => ProjectGraphSnapshot;
|
|
37
|
+
/**
|
|
38
|
+
* The same findings from the graph this process has already built, so a process that linted the side hands them out without building the graph again.
|
|
39
|
+
*
|
|
40
|
+
* The rules read one graph per process and per side, built when the first file is linted. The ESLint child of `starci app check --gate lint` calls
|
|
41
|
+
* this after its run and writes the result beside its report; the result cache keeps the graph findings from it instead of building the graph a
|
|
42
|
+
* second time in the CLI. A process that has not built the graph yet builds it here, once, exactly as `projectGraph` does, and the value is the
|
|
43
|
+
* same: `projectGraph` is a fresh build, this is the build the rules used.
|
|
44
|
+
*
|
|
45
|
+
* @param input - The side folder (`repoRoot`, the folder of the side's `eslint.config.mjs`).
|
|
46
|
+
* @returns The findings of the rules of `recommended`, keyed by path relative to the side folder.
|
|
47
|
+
*/
|
|
48
|
+
export declare const projectGraphSnapshot: ({ repoRoot }: {
|
|
49
|
+
repoRoot: string;
|
|
50
|
+
}) => ProjectGraphSnapshot;
|
package/dist/project-graph.js
CHANGED
|
@@ -32,7 +32,22 @@ export const recommended = Object.fromEntries(mine.map((e) => [`starci-be/${e.id
|
|
|
32
32
|
*/
|
|
33
33
|
export const projectGraph = ({ repoRoot, injectedTypeScript }) => {
|
|
34
34
|
resetProjectGraphs();
|
|
35
|
-
|
|
35
|
+
return snapshotOf(buildProjectGraph({ repoRoot, ...(injectedTypeScript === undefined ? {} : { injectedTypeScript }), runtimeRoot: RUNTIME_ROOT }));
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* The same findings from the graph this process has already built, so a process that linted the side hands them out without building the graph again.
|
|
39
|
+
*
|
|
40
|
+
* The rules read one graph per process and per side, built when the first file is linted. The ESLint child of `starci app check --gate lint` calls
|
|
41
|
+
* this after its run and writes the result beside its report; the result cache keeps the graph findings from it instead of building the graph a
|
|
42
|
+
* second time in the CLI. A process that has not built the graph yet builds it here, once, exactly as `projectGraph` does, and the value is the
|
|
43
|
+
* same: `projectGraph` is a fresh build, this is the build the rules used.
|
|
44
|
+
*
|
|
45
|
+
* @param input - The side folder (`repoRoot`, the folder of the side's `eslint.config.mjs`).
|
|
46
|
+
* @returns The findings of the rules of `recommended`, keyed by path relative to the side folder.
|
|
47
|
+
*/
|
|
48
|
+
export const projectGraphSnapshot = ({ repoRoot }) => snapshotOf(buildProjectGraph({ repoRoot, runtimeRoot: RUNTIME_ROOT }));
|
|
49
|
+
/** The findings of the rules of this canon in a built graph, by side-relative path, each list sorted by line, column, code and message. */
|
|
50
|
+
const snapshotOf = (graph) => {
|
|
36
51
|
const byFile = {};
|
|
37
52
|
for (const [file, findings] of graph.byFile) {
|
|
38
53
|
for (const finding of findings) {
|
package/package.json
CHANGED
package/runtime/bundle.json
CHANGED
|
@@ -126,6 +126,7 @@
|
|
|
126
126
|
"scripts/hfs/declaration-shape.mjs",
|
|
127
127
|
"scripts/hfs/declaration-slots.mjs",
|
|
128
128
|
"scripts/hfs/edition-slots.mjs",
|
|
129
|
+
"scripts/hfs/explicit-surface-rule.mjs",
|
|
129
130
|
"scripts/hfs/linear-text.mjs",
|
|
130
131
|
"scripts/hfs/param-names.mjs",
|
|
131
132
|
"scripts/hfs/path-findings.mjs",
|
|
@@ -151,6 +152,7 @@
|
|
|
151
152
|
"scripts/hfs/trailing-slashes.mjs",
|
|
152
153
|
"scripts/hfs/typescript-programs.mjs",
|
|
153
154
|
"scripts/hfs/view.mjs",
|
|
155
|
+
"scripts/lib/declaration-surface.mjs",
|
|
154
156
|
"scripts/lib/dockerfile.mjs",
|
|
155
157
|
"scripts/lib/env.mjs",
|
|
156
158
|
"scripts/lib/event-contract.mjs",
|
|
@@ -30,36 +30,43 @@ pins:
|
|
|
30
30
|
side: fe
|
|
31
31
|
source: packages/event-stream/package.json
|
|
32
32
|
why: 'the one server-sent-events client of every front end (fe-stack event-stream, owner:event-stream-package): the transport client layer (modules/api/sse/clients) creates one instance for the app with the bearer token source and the stream operations follow on it; it carries Last-Event-ID resume, the capped doubling backoff, the heartbeat timeout, the single 401 renewal and the useSWRSubscription adapter, so no app keeps a hand-written reader.'
|
|
33
|
+
'@starci/next-data':
|
|
34
|
+
version: 0.1.0
|
|
35
|
+
group: starci
|
|
36
|
+
install: registry
|
|
37
|
+
side: fe
|
|
38
|
+
source: packages/next-data/package.json
|
|
39
|
+
why: 'the SWR data helpers of every front end (fe-stack data, owner:next-data-package): pollingRestart, the viewer and tenant key helpers, viewerSwrConfig and the viewer cache; each operation hook stays in the app and the package holds no component.'
|
|
33
40
|
'@starci/grammar':
|
|
34
|
-
version: 0.21.
|
|
41
|
+
version: 0.21.14
|
|
35
42
|
group: starci
|
|
36
43
|
install: registry
|
|
37
44
|
side: fe
|
|
38
45
|
source: packages/grammar/package.json
|
|
39
46
|
why: 'the grammar front ends read: the brand layer sets `--font-sans` and `--font-mono` and the grammar reads them; it carries the Input tel kind, the copyable and read-only Input, the IconButton disclosure props and count badge, ChatBubble, FillViewport, Textarea mentions and Enter-to-send, the leading PrimaryRailLayout rail, the plate-less Image, ListRow, the soft Alert, Progress steps, the floating primary IconButton, FlowGraph, the STATE-8 loading views and the bordered selectable TagGroup chips. The runtime source version wins for a @starci package.'
|
|
40
47
|
'@starci/eslint-canon-be':
|
|
41
|
-
version: 3.
|
|
48
|
+
version: 3.13.0
|
|
42
49
|
group: starci
|
|
43
50
|
install: registry
|
|
44
51
|
side: be
|
|
45
52
|
source: packages/eslint-canon-be/package.json
|
|
46
53
|
why: 'the back-end ESLint canon: `loadHfs(import.meta.url)` of be/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the be side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; `starciBeConfig({ hfs: loadHfs(import.meta.url) })` is the typed factory and the BE-CONVENTION laws are its rules.'
|
|
47
54
|
'@starci/eslint-canon-fe':
|
|
48
|
-
version: 9.
|
|
55
|
+
version: 9.11.0
|
|
49
56
|
group: starci
|
|
50
57
|
install: registry
|
|
51
58
|
side: fe
|
|
52
59
|
source: packages/eslint-canon-fe/package.json
|
|
53
60
|
why: 'the front-end ESLint canon: `loadHfs(import.meta.url)` of fe/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the fe side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; the front end has no tests (FE_NO_TESTS R97 in hfs) and no-vietnamese-in-source (R91) applies.'
|
|
54
61
|
'@starci/eslint-grammar-core':
|
|
55
|
-
version: 0.21.
|
|
62
|
+
version: 0.21.14
|
|
56
63
|
group: starci
|
|
57
64
|
install: registry
|
|
58
65
|
side: fe
|
|
59
66
|
source: packages/eslint-grammar-core/package.json
|
|
60
67
|
why: 'the StarCi Grammar component API lint, versioned with @starci/grammar; front ends compose this family package with the universal FE canon.'
|
|
61
68
|
'@starci/eslint-grammar-offset-pop':
|
|
62
|
-
version: 0.21.
|
|
69
|
+
version: 0.21.14
|
|
63
70
|
group: starci
|
|
64
71
|
install: registry
|
|
65
72
|
side: fe
|
|
@@ -85,14 +92,14 @@ pins:
|
|
|
85
92
|
side: both
|
|
86
93
|
source: packages/prettier-config/package.json
|
|
87
94
|
'@starci/jest-preset':
|
|
88
|
-
version: 2.6.
|
|
95
|
+
version: 2.6.1
|
|
89
96
|
group: starci
|
|
90
97
|
install: registry
|
|
91
98
|
side: be
|
|
92
99
|
source: packages/jest-preset/package.json
|
|
93
100
|
why: 'the Jest preset of a back end: the world runner runs up to min(--maxWorkers, slots) world files at once, each in its own process bound to one data slot of the test world (STARCI_TEST_WORLD_SLOT), and reads test-world state protocol 2 only: it pairs exactly with @starci/test-world, and any other state file is JEST_PRESET_WORLD_PAIR_MISMATCH. The unit run writes the lcov Sonar and Codecov import (services only); the integration, e2e and contract projects run every spec file in a worker process of its own (world-runner.cjs), so a process-global framework registry (@nestjs/graphql type metadata) never leaks between e2e files; it ships the unit kit (mockEntityManager, fakeTransaction, fakeQueryBuilder, queueQueryBuilders, fakeIds, FakeClock, Outcome matchers) and the recordingOutbox claim side.'
|
|
94
101
|
'@starci/test-world':
|
|
95
|
-
version: 1.3.
|
|
102
|
+
version: 1.3.4
|
|
96
103
|
group: starci
|
|
97
104
|
install: registry
|
|
98
105
|
side: be
|
|
@@ -105,8 +112,22 @@ pins:
|
|
|
105
112
|
side: be
|
|
106
113
|
source: packages/ai-router/package.json
|
|
107
114
|
why: 'the AI pool router of a back end: a NestJS module that routes OpenAI-compatible chat, stream and embeddings calls across keys, models and providers, with @starci/ai-router/testing for its specs; @starci/jest-preset compiles it as an ESM-only dependency.'
|
|
115
|
+
'@starci/auth':
|
|
116
|
+
version: 0.1.0
|
|
117
|
+
group: starci
|
|
118
|
+
install: registry
|
|
119
|
+
side: both
|
|
120
|
+
source: packages/auth/package.json
|
|
121
|
+
why: 'the lite sign-in: the NestJS module (EdDSA access tokens with a multi-key JWKS, passwords, Google OAuth with state and PKCE, rotating refresh sessions, the sign-in budget, the refresh cookie), the front-end client and its React bindings, the door contracts and test doubles; the one importer of the identity libraries, reached by a back end only through integrations/passport; @starci/jest-preset compiles it as an ESM-only dependency.'
|
|
122
|
+
'@starci/object-storage':
|
|
123
|
+
version: 0.1.0
|
|
124
|
+
group: starci
|
|
125
|
+
install: registry
|
|
126
|
+
side: be
|
|
127
|
+
source: packages/object-storage/package.json
|
|
128
|
+
why: 'object storage of a back end: a NestJS module and the ObjectStorage port over S3-compatible storage (presigned PUT and GET that sign the content type and size, head, get, put, list, delete, bucket setup, size and content-type limits, coded errors), with @starci/object-storage/testing for its specs; the only importer of @aws-sdk/client-s3 and @aws-sdk/s3-request-presigner (R331).'
|
|
108
129
|
'@starci/hfs':
|
|
109
|
-
version: 5.0
|
|
130
|
+
version: 5.2.0
|
|
110
131
|
group: starci
|
|
111
132
|
install: registry
|
|
112
133
|
side: both
|
|
@@ -543,12 +564,12 @@ pins:
|
|
|
543
564
|
version: 3.1150.0
|
|
544
565
|
group: framework
|
|
545
566
|
side: be
|
|
546
|
-
why: 'the S3 transport
|
|
567
|
+
why: 'the S3 transport inside @starci/object-storage, the one ObjectStorage adapter of both editions (MinIO, S3, Spaces), which depends on it at exactly this version and which no app file imports; 3.1150.0 is the release of 2026-10-12, chosen over newer ones that had not aged two weeks.'
|
|
547
568
|
'@aws-sdk/s3-request-presigner':
|
|
548
569
|
version: 3.1150.0
|
|
549
570
|
group: framework
|
|
550
571
|
side: be
|
|
551
|
-
why: 'signs the presigned PUT and GET
|
|
572
|
+
why: 'signs the presigned PUT and GET inside @starci/object-storage locally, the same release as client-s3; no app file imports it.'
|
|
552
573
|
'@apollo/server':
|
|
553
574
|
version: 5.5.1
|
|
554
575
|
group: framework
|
|
@@ -37,17 +37,17 @@ concerns:
|
|
|
37
37
|
- id: rest
|
|
38
38
|
tier: core
|
|
39
39
|
packages: [axios]
|
|
40
|
-
home: [fe.modules.api
|
|
40
|
+
home: [fe.modules.api]
|
|
41
41
|
pattern: FE-API-REST
|
|
42
42
|
forbids: [ky, superagent, node-fetch, cross-fetch, isomorphic-fetch]
|
|
43
|
-
why: modules/api/rest/<area>/*.ts for uploads and presigned URLs,
|
|
43
|
+
why: modules/api/rest/<area>/*.ts for uploads and presigned URLs, only; GraphQL carries every other call.
|
|
44
44
|
- id: data
|
|
45
45
|
tier: core
|
|
46
|
-
packages: [swr]
|
|
46
|
+
packages: [swr, '@starci/next-data']
|
|
47
47
|
home: [fe.hooks.swr]
|
|
48
48
|
pattern: FE-DATA-SWR
|
|
49
49
|
forbids: ['@tanstack/react-query', react-query]
|
|
50
|
-
why: hooks/swr/api/{graphql,rest}/{queries,mutations}/use*Swr.ts wrap one operation each; components call hooks only.
|
|
50
|
+
why: hooks/swr/api/{graphql,rest}/{queries,mutations}/use*Swr.ts wrap one operation each; components call hooks only. The polling-restart middleware (pollingRestart), the key helpers, the viewer-keyed config and the viewer cache are @starci/next-data's (owner next-data-package); an app imports no Middleware or ScopedMutator type of swr and writes none of them.
|
|
51
51
|
- id: toast
|
|
52
52
|
tier: core
|
|
53
53
|
packages: ['@heroui/react']
|
|
@@ -96,11 +96,11 @@ concerns:
|
|
|
96
96
|
hand-written reader (read-event-stream.ts) and no second SSE library is installed.
|
|
97
97
|
- id: auth
|
|
98
98
|
tier: core
|
|
99
|
-
packages: []
|
|
99
|
+
packages: ['@starci/auth']
|
|
100
100
|
home: [fe.modules.auth]
|
|
101
101
|
pattern: FE-AUTH
|
|
102
|
-
forbids: ['@supabase/supabase-js', '@supabase/ssr', '@supabase/auth-js']
|
|
103
|
-
why: modules/auth is the session issuer's client (
|
|
102
|
+
forbids: ['@supabase/supabase-js', '@supabase/ssr', '@supabase/auth-js', jose, jwt-decode, next-auth, '@auth/core', keycloak-js, oidc-client-ts]
|
|
103
|
+
why: modules/auth is the session issuer's client (one @starci/auth client instance over the app's own back-end auth doors, the access token in its memory; full - the app's IdP client); it yields the session and the access token for the Apollo link and never reads data.
|
|
104
104
|
- id: i18n
|
|
105
105
|
tier: core
|
|
106
106
|
packages: [next-intl]
|