@quickback-dev/cli 0.54.0 → 0.55.1

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.
Files changed (95) hide show
  1. package/dist/commands/compile.d.ts.map +1 -1
  2. package/dist/commands/compile.js +41 -4
  3. package/dist/commands/compile.js.map +1 -1
  4. package/dist/commands/create.d.ts.map +1 -1
  5. package/dist/commands/create.js +5 -1
  6. package/dist/commands/create.js.map +1 -1
  7. package/dist/docs/content.d.ts.map +1 -1
  8. package/dist/docs/content.js +37 -22
  9. package/dist/docs/content.js.map +1 -1
  10. package/dist/index.js +1 -1
  11. package/dist/lib/action-harvest.d.ts +16 -1
  12. package/dist/lib/action-harvest.d.ts.map +1 -1
  13. package/dist/lib/action-harvest.js +21 -1
  14. package/dist/lib/action-harvest.js.map +1 -1
  15. package/dist/lib/action-harvest.test.js +122 -3
  16. package/dist/lib/action-harvest.test.js.map +1 -1
  17. package/dist/lib/api-client.d.ts +11 -0
  18. package/dist/lib/api-client.d.ts.map +1 -1
  19. package/dist/lib/api-client.js.map +1 -1
  20. package/dist/lib/artifact-routing.d.ts.map +1 -1
  21. package/dist/lib/artifact-routing.js +3 -0
  22. package/dist/lib/artifact-routing.js.map +1 -1
  23. package/dist/lib/compiler-floor.d.ts +39 -0
  24. package/dist/lib/compiler-floor.d.ts.map +1 -0
  25. package/dist/lib/compiler-floor.js +75 -0
  26. package/dist/lib/compiler-floor.js.map +1 -0
  27. package/dist/lib/compiler-floor.test.d.ts +2 -0
  28. package/dist/lib/compiler-floor.test.d.ts.map +1 -0
  29. package/dist/lib/compiler-floor.test.js +67 -0
  30. package/dist/lib/compiler-floor.test.js.map +1 -0
  31. package/dist/lib/compiler-stubs.d.ts +6 -0
  32. package/dist/lib/compiler-stubs.d.ts.map +1 -1
  33. package/dist/lib/compiler-stubs.js +8 -0
  34. package/dist/lib/compiler-stubs.js.map +1 -1
  35. package/dist/lib/file-loader.d.ts +45 -4
  36. package/dist/lib/file-loader.d.ts.map +1 -1
  37. package/dist/lib/file-loader.js +116 -19
  38. package/dist/lib/file-loader.js.map +1 -1
  39. package/dist/lib/file-loader.test.js +80 -4
  40. package/dist/lib/file-loader.test.js.map +1 -1
  41. package/dist/skill/SKILL.md +3 -1
  42. package/dist/skill/docs/changelog.md +66 -0
  43. package/dist/skill/docs/compiler/config/index.md +14 -1
  44. package/dist/skill/docs/compiler/config/providers.md +13 -9
  45. package/dist/skill/docs/compiler/definitions/access.md +134 -2
  46. package/dist/skill/docs/compiler/definitions/actions.md +22 -0
  47. package/dist/skill/docs/compiler/definitions/changesets.md +375 -0
  48. package/dist/skill/docs/compiler/definitions/feature-areas.md +189 -0
  49. package/dist/skill/docs/compiler/definitions/feature.md +33 -0
  50. package/dist/skill/docs/compiler/definitions/firewall.md +60 -1
  51. package/dist/skill/docs/compiler/definitions/guards.md +14 -0
  52. package/dist/skill/docs/compiler/definitions/index.md +28 -3
  53. package/dist/skill/docs/compiler/definitions/masking.md +8 -0
  54. package/dist/skill/docs/compiler/definitions/read.md +13 -0
  55. package/dist/skill/docs/compiler/definitions/schema.md +36 -1
  56. package/dist/skill/docs/compiler/definitions/scopes.md +23 -1
  57. package/dist/skill/docs/compiler/targets/hono-api/database/neon.md +27 -28
  58. package/dist/skill/docs/compiler/targets/hono-api/using-the-api/batch-operations.md +2 -0
  59. package/dist/skill/docs/compiler/targets/hono-api/using-the-api/errors.md +49 -17
  60. package/dist/skill/docs/compiler/targets/hono-api/using-the-api/query-params.md +66 -0
  61. package/dist/skill/docs/stack/api-contract/index.md +136 -0
  62. package/dist/skill/docs/stack/realtime/durable-objects.md +7 -0
  63. package/dist/skill/docs/stack/realtime/index.md +22 -0
  64. package/dist/skill/docs/stack/realtime/live-views.md +56 -0
  65. package/dist/skill/docs/stack/realtime/using-realtime.md +53 -0
  66. package/dist/skill/docs/stack/webhooks/inbound.md +79 -0
  67. package/dist/skill/docs/stack/webhooks/outbound.md +33 -0
  68. package/package.json +1 -1
  69. package/src/skill/SKILL.md +3 -1
  70. package/src/skill/docs/changelog.md +66 -0
  71. package/src/skill/docs/compiler/config/index.md +14 -1
  72. package/src/skill/docs/compiler/config/providers.md +13 -9
  73. package/src/skill/docs/compiler/definitions/access.md +134 -2
  74. package/src/skill/docs/compiler/definitions/actions.md +22 -0
  75. package/src/skill/docs/compiler/definitions/changesets.md +375 -0
  76. package/src/skill/docs/compiler/definitions/feature-areas.md +189 -0
  77. package/src/skill/docs/compiler/definitions/feature.md +33 -0
  78. package/src/skill/docs/compiler/definitions/firewall.md +60 -1
  79. package/src/skill/docs/compiler/definitions/guards.md +14 -0
  80. package/src/skill/docs/compiler/definitions/index.md +28 -3
  81. package/src/skill/docs/compiler/definitions/masking.md +8 -0
  82. package/src/skill/docs/compiler/definitions/read.md +13 -0
  83. package/src/skill/docs/compiler/definitions/schema.md +36 -1
  84. package/src/skill/docs/compiler/definitions/scopes.md +23 -1
  85. package/src/skill/docs/compiler/targets/hono-api/database/neon.md +27 -28
  86. package/src/skill/docs/compiler/targets/hono-api/using-the-api/batch-operations.md +2 -0
  87. package/src/skill/docs/compiler/targets/hono-api/using-the-api/errors.md +49 -17
  88. package/src/skill/docs/compiler/targets/hono-api/using-the-api/query-params.md +66 -0
  89. package/src/skill/docs/stack/api-contract/index.md +136 -0
  90. package/src/skill/docs/stack/realtime/durable-objects.md +7 -0
  91. package/src/skill/docs/stack/realtime/index.md +22 -0
  92. package/src/skill/docs/stack/realtime/live-views.md +56 -0
  93. package/src/skill/docs/stack/realtime/using-realtime.md +53 -0
  94. package/src/skill/docs/stack/webhooks/inbound.md +79 -0
  95. package/src/skill/docs/stack/webhooks/outbound.md +33 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiler-floor.d.ts","sourceRoot":"","sources":["../../src/lib/compiler-floor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAErD,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAA8B,CAAC;AAEvF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAsB5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAGjF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKlG"}
@@ -0,0 +1,75 @@
1
+ /**
2
+ * Feature-areas compiler floor + capability recognition (hierarchical
3
+ * areas, v2 feature 01) — extracted from commands/compile.ts so the
4
+ * fail-closed predicates are unit-testable (design §3.3 last row / §6
5
+ * row 15: the CLI must refuse output from a compiler that predates the
6
+ * `areas` payload, INCLUDING when meta.version is absent entirely).
7
+ */
8
+ /**
9
+ * The oldest compiler version whose /compile understands the `areas`
10
+ * payload. When the project declares areas and the responding compiler's
11
+ * meta.version is BELOW this floor — or the version field is ABSENT
12
+ * (pre-meta compilers) — the CLI fails BEFORE accepting output: an old
13
+ * compiler silently ignores the unknown `areas` key and would compile the
14
+ * project without its area namespaces.
15
+ */
16
+ export const FEATURE_AREAS_COMPILER_FLOOR = '0.56.0';
17
+ /** Capability names this CLI understands (config `requires: [...]`). */
18
+ export const RECOGNIZED_CAPABILITIES = new Set(['feature-areas']);
19
+ /**
20
+ * Semver compare over `major.minor.patch` with prerelease awareness:
21
+ * `0.56.0-beta` orders BELOW `0.56.0` (SemVer §11) — a prerelease compiler
22
+ * that predates the final area contract must not pass a floor set at the
23
+ * release version. Build metadata (`+...`) is ignored per SemVer §10.
24
+ * Numeric components are compared numerically; a missing component is 0.
25
+ */
26
+ export function compareVersions(a, b) {
27
+ const parse = (v) => {
28
+ const noBuild = v.split('+')[0];
29
+ const dash = noBuild.indexOf('-');
30
+ const core = dash === -1 ? noBuild : noBuild.slice(0, dash);
31
+ const prerelease = dash === -1 ? null : noBuild.slice(dash + 1);
32
+ return { nums: core.split('.').map((n) => parseInt(n, 10) || 0), prerelease };
33
+ };
34
+ const pa = parse(a);
35
+ const pb = parse(b);
36
+ for (let i = 0; i < 3; i++) {
37
+ const da = pa.nums[i] ?? 0;
38
+ const db = pb.nums[i] ?? 0;
39
+ if (da !== db)
40
+ return da - db;
41
+ }
42
+ // Same core triple: a prerelease sorts below the release. Two prereleases
43
+ // compare by code point — precise SemVer identifier ordering does not
44
+ // matter for a floor check (the floor is always a release version).
45
+ if (pa.prerelease === pb.prerelease)
46
+ return 0;
47
+ if (pa.prerelease === null)
48
+ return 1;
49
+ if (pb.prerelease === null)
50
+ return -1;
51
+ return pa.prerelease < pb.prerelease ? -1 : 1;
52
+ }
53
+ /**
54
+ * Fail-closed floor predicate: true when the reported compiler version
55
+ * satisfies the feature-areas floor. Absent/empty version → false (never
56
+ * assume support).
57
+ */
58
+ export function compilerSupportsAreas(version) {
59
+ if (!version)
60
+ return false;
61
+ return compareVersions(version, FEATURE_AREAS_COMPILER_FLOOR) >= 0;
62
+ }
63
+ /**
64
+ * The first `requires:` capability this CLI does not recognize, or
65
+ * undefined when all are known. An unknown capability means this CLI
66
+ * predates it — the caller must fail before loading anything.
67
+ */
68
+ export function firstUnknownCapability(requires) {
69
+ for (const cap of requires ?? []) {
70
+ if (!RECOGNIZED_CAPABILITIES.has(cap))
71
+ return cap;
72
+ }
73
+ return undefined;
74
+ }
75
+ //# sourceMappingURL=compiler-floor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiler-floor.js","sourceRoot":"","sources":["../../src/lib/compiler-floor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,QAAQ,CAAC;AAErD,wEAAwE;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;AAEvF;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,KAAK,GAAG,CAAC,CAAS,EAAiD,EAAE;QACzE,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;IAChF,CAAC,CAAC;IACF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAChC,CAAC;IACD,0EAA0E;IAC1E,sEAAsE;IACtE,oEAAoE;IACpE,IAAI,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAkC;IACtE,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,eAAe,CAAC,OAAO,EAAE,4BAA4B,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAuC;IAC5E,KAAK,MAAM,GAAG,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QACjC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=compiler-floor.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiler-floor.test.d.ts","sourceRoot":"","sources":["../../src/lib/compiler-floor.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,67 @@
1
+ /**
2
+ * Feature-areas compiler floor — the CLI-side fail-closed guard
3
+ * (design §3.3 last row / §6 row 15). The CLI must refuse a compiler
4
+ * response for an area project when the responding compiler predates the
5
+ * `areas` payload — INCLUDING when meta.version is absent entirely
6
+ * (pre-meta compilers), the amendment accepted from security review.
7
+ */
8
+ import { describe, expect, test } from 'bun:test';
9
+ import { FEATURE_AREAS_COMPILER_FLOOR, RECOGNIZED_CAPABILITIES, compareVersions, compilerSupportsAreas, firstUnknownCapability, } from './compiler-floor.js';
10
+ describe('compareVersions', () => {
11
+ test('orders release triples numerically, not lexically', () => {
12
+ expect(compareVersions('0.55.0', '0.56.0')).toBeLessThan(0);
13
+ expect(compareVersions('0.56.0', '0.56.0')).toBe(0);
14
+ expect(compareVersions('0.56.1', '0.56.0')).toBeGreaterThan(0);
15
+ expect(compareVersions('0.100.0', '0.56.0')).toBeGreaterThan(0);
16
+ expect(compareVersions('1.0.0', '0.99.99')).toBeGreaterThan(0);
17
+ });
18
+ test('a prerelease sorts BELOW its release (0.56.0-beta < 0.56.0)', () => {
19
+ expect(compareVersions('0.56.0-beta', '0.56.0')).toBeLessThan(0);
20
+ expect(compareVersions('0.56.0', '0.56.0-beta')).toBeGreaterThan(0);
21
+ });
22
+ test('a prerelease of a HIGHER triple still passes a lower floor', () => {
23
+ expect(compareVersions('0.57.0-beta', '0.56.0')).toBeGreaterThan(0);
24
+ });
25
+ test('build metadata is ignored (SemVer §10)', () => {
26
+ expect(compareVersions('0.56.0+build.7', '0.56.0')).toBe(0);
27
+ });
28
+ });
29
+ describe('compilerSupportsAreas — fail-closed floor predicate', () => {
30
+ test('exactly the floor passes', () => {
31
+ expect(compilerSupportsAreas(FEATURE_AREAS_COMPILER_FLOOR)).toBe(true);
32
+ expect(compilerSupportsAreas('0.56.0')).toBe(true);
33
+ });
34
+ test('above the floor passes', () => {
35
+ expect(compilerSupportsAreas('0.56.1')).toBe(true);
36
+ expect(compilerSupportsAreas('0.57.0')).toBe(true);
37
+ expect(compilerSupportsAreas('1.0.0')).toBe(true);
38
+ });
39
+ test('below the floor is refused', () => {
40
+ expect(compilerSupportsAreas('0.55.0')).toBe(false);
41
+ expect(compilerSupportsAreas('0.55.9')).toBe(false);
42
+ });
43
+ test('ABSENT version is refused — never assume support (pre-meta compilers)', () => {
44
+ expect(compilerSupportsAreas(undefined)).toBe(false);
45
+ expect(compilerSupportsAreas(null)).toBe(false);
46
+ expect(compilerSupportsAreas('')).toBe(false);
47
+ });
48
+ test('a prerelease of the floor version is refused (predates the final area contract)', () => {
49
+ expect(compilerSupportsAreas('0.56.0-beta')).toBe(false);
50
+ expect(compilerSupportsAreas('0.56.0-rc.1')).toBe(false);
51
+ });
52
+ });
53
+ describe('firstUnknownCapability — requires: [...] fast-fail', () => {
54
+ test('all-known requires pass', () => {
55
+ expect(firstUnknownCapability(['feature-areas'])).toBeUndefined();
56
+ expect(firstUnknownCapability([])).toBeUndefined();
57
+ expect(firstUnknownCapability(undefined)).toBeUndefined();
58
+ });
59
+ test('an unknown capability is surfaced (this CLI predates it)', () => {
60
+ expect(firstUnknownCapability(['feature-areas', 'time-travel'])).toBe('time-travel');
61
+ expect(firstUnknownCapability(['time-travel'])).toBe('time-travel');
62
+ });
63
+ test('the recognized set is exactly the shipped capability list', () => {
64
+ expect([...RECOGNIZED_CAPABILITIES].sort()).toEqual(['feature-areas']);
65
+ });
66
+ });
67
+ //# sourceMappingURL=compiler-floor.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiler-floor.test.js","sourceRoot":"","sources":["../../src/lib/compiler-floor.test.ts"],"names":[],"mappings":"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"}
@@ -85,6 +85,12 @@ export declare function defineActions<TSchema>(schema: TSchema, actions: Record<
85
85
  * Stub for defineAction - returns a curried function that returns the config
86
86
  */
87
87
  export declare function defineAction<TSchema = unknown>(): (config: Record<string, unknown>) => Record<string, unknown>;
88
+ /**
89
+ * Stub for defineArea - returns the area definition as-is.
90
+ * Used in features/<area>/_area.ts (feature areas). The compiler
91
+ * re-validates the transported definition server-side.
92
+ */
93
+ export declare function defineArea(definition: Record<string, unknown>): Record<string, unknown>;
88
94
  /**
89
95
  * Stub for defineQueue - returns the queue handler definition
90
96
  * Used in definitions/services/queues/*.ts
@@ -1 +1 @@
1
- {"version":3,"file":"compiler-stubs.d.ts","sourceRoot":"","sources":["../../src/lib/compiler-stubs.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"compiler-stubs.d.ts","sourceRoot":"","sources":["../../src/lib/compiler-stubs.ts"],"names":[],"mappings":"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"}
@@ -111,6 +111,14 @@ export function defineActions(schema, actions) {
111
111
  export function defineAction() {
112
112
  return (config) => config;
113
113
  }
114
+ /**
115
+ * Stub for defineArea - returns the area definition as-is.
116
+ * Used in features/<area>/_area.ts (feature areas). The compiler
117
+ * re-validates the transported definition server-side.
118
+ */
119
+ export function defineArea(definition) {
120
+ return definition;
121
+ }
114
122
  /**
115
123
  * Stub for defineQueue - returns the queue handler definition
116
124
  * Used in definitions/services/queues/*.ts
@@ -1 +1 @@
1
- {"version":3,"file":"compiler-stubs.js","sourceRoot":"","sources":["../../src/lib/compiler-stubs.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"compiler-stubs.js","sourceRoot":"","sources":["../../src/lib/compiler-stubs.ts"],"names":[],"mappings":"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"}
@@ -68,6 +68,23 @@ export interface LoadedPageDefinition {
68
68
  */
69
69
  export interface LoadedFeature {
70
70
  name: string;
71
+ /**
72
+ * Ancestor AREA directory names, outermost first (feature areas). E.g.
73
+ * `['events']` for `features/events/travel/`. Absent for top-level flat
74
+ * features. Feature identity stays the LEAF folder name.
75
+ */
76
+ areaPath?: string[];
77
+ /**
78
+ * The AUTHORED feature directory relative to `featuresDir`, POSIX-normalized,
79
+ * exactly as discovered on disk (e.g. `todos` for a flat feature, `events`
80
+ * for an area folder that is itself a feature, `events/conversations` for a
81
+ * leaf nested under an area). This is the source-lookup path — distinct from
82
+ * `name`, which stays the global LEAF identity and drives the compiler
83
+ * staging key. Consumers that reconstruct an on-disk source path (notably the
84
+ * v2 action-schema harvest) MUST use this, not `name`, or nested-area actions
85
+ * resolve to a directory that does not contain the file.
86
+ */
87
+ sourceDir?: string;
71
88
  /** Primary schema (first table with defineTable) */
72
89
  schema: {
73
90
  tableName: string;
@@ -170,14 +187,38 @@ export interface LoadedServices {
170
187
  */
171
188
  export declare function loadConfig(configPath: string): Promise<LoadedConfig>;
172
189
  /**
173
- * Load all features from quickback/features/.
190
+ * One `_area.ts` node discovered under features/ (feature areas).
191
+ * `definition` is the executed default export of the file — the same
192
+ * passthrough-stub treatment `quickback.config.ts` gets; the compiler
193
+ * validates the transported definition server-side.
194
+ */
195
+ export interface LoadedArea {
196
+ /** Folder names from features/ down to the area, e.g. ['events']. */
197
+ dirPath: string[];
198
+ definition: Record<string, unknown>;
199
+ }
200
+ export interface LoadedFeatureTree {
201
+ features: LoadedFeature[];
202
+ areas: LoadedArea[];
203
+ }
204
+ /**
205
+ * Load all features from quickback/features/ — RECURSIVE tree walk
206
+ * (feature areas). A directory carrying `_area.ts` is an AREA: it may
207
+ * itself be a feature (root tables + actions/) and every unreserved child
208
+ * directory is a child feature (or a child area — arbitrary depth). A
209
+ * directory WITHOUT `_area.ts` is a leaf feature; its unreserved subdirs
210
+ * are NOT loaded — a subdir carrying defineTable(...)/defineAction(...)
211
+ * fails the load (silent route/table disappearance after a mis-move is the
212
+ * worst failure mode areas can introduce).
213
+ *
214
+ * Feature leaf names must be unique project-wide (they key generated
215
+ * src/features/<name>/ paths).
174
216
  *
175
217
  * After each feature loads, conflicts are batched and thrown as one error
176
218
  * block — keeps migration of an existing project to a single round-trip
177
- * instead of N. The loader emits no warnings; everything that needs the
178
- * user's attention is an actionable conflict pointing at the migration.
219
+ * instead of N.
179
220
  */
180
- export declare function loadFeatures(featuresDir: string): Promise<LoadedFeature[]>;
221
+ export declare function loadFeatures(featuresDir: string): Promise<LoadedFeatureTree>;
181
222
  /**
182
223
  * Find the config file path
183
224
  */
@@ -1 +1 @@
1
- {"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../src/lib/file-loader.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../src/lib/file-loader.ts"],"names":[],"mappings":"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"}
@@ -7,7 +7,7 @@
7
7
  * Loads defineTable() definitions from *.ts feature files.
8
8
  */
9
9
  import { promises as fs } from 'fs';
10
- import { join, basename, dirname } from 'path';
10
+ import { join, basename, dirname, relative, sep } from 'path';
11
11
  import { createHash } from 'crypto';
12
12
  import { build } from 'esbuild';
13
13
  import { fileURLToPath } from 'url';
@@ -181,28 +181,120 @@ export async function loadConfig(configPath) {
181
181
  preset: preset || 'cloudflare',
182
182
  };
183
183
  }
184
+ /** Reserved feature sub-directories — never child features of an area. */
185
+ const RESERVED_FEATURE_SUBDIRS = new Set(['actions', 'lib', 'pages', 'handlers']);
184
186
  /**
185
- * Load all features from quickback/features/.
187
+ * Load all features from quickback/features/ — RECURSIVE tree walk
188
+ * (feature areas). A directory carrying `_area.ts` is an AREA: it may
189
+ * itself be a feature (root tables + actions/) and every unreserved child
190
+ * directory is a child feature (or a child area — arbitrary depth). A
191
+ * directory WITHOUT `_area.ts` is a leaf feature; its unreserved subdirs
192
+ * are NOT loaded — a subdir carrying defineTable(...)/defineAction(...)
193
+ * fails the load (silent route/table disappearance after a mis-move is the
194
+ * worst failure mode areas can introduce).
195
+ *
196
+ * Feature leaf names must be unique project-wide (they key generated
197
+ * src/features/<name>/ paths).
186
198
  *
187
199
  * After each feature loads, conflicts are batched and thrown as one error
188
200
  * block — keeps migration of an existing project to a single round-trip
189
- * instead of N. The loader emits no warnings; everything that needs the
190
- * user's attention is an actionable conflict pointing at the migration.
201
+ * instead of N.
191
202
  */
192
203
  export async function loadFeatures(featuresDir) {
193
204
  if (!(await pathExists(featuresDir))) {
194
- return [];
195
- }
196
- const entries = await readdirSorted(featuresDir);
197
- const featureDirs = entries
198
- .filter((d) => d.isDirectory())
199
- .map((d) => d.name);
200
- const results = new Array(featureDirs.length);
201
- await runWithLimit(featureDirs.map((name, index) => ({ name, index })), READ_CONCURRENCY, async ({ name, index }) => {
202
- const featureDir = join(featuresDir, name);
203
- results[index] = await loadFeature(name, featureDir);
204
- });
205
- const loaded = results.filter((f) => Boolean(f));
205
+ return { features: [], areas: [] };
206
+ }
207
+ const loaded = [];
208
+ const areas = [];
209
+ const nameToDir = new Map();
210
+ const registerName = (name, dir) => {
211
+ const prior = nameToDir.get(name);
212
+ if (prior) {
213
+ throw new Error(`Two features share the name "${name}": ${prior} and ${dir}. Feature names must be ` +
214
+ `unique project-wide (they key generated src/features/<name>/ paths). Rename one folder.`);
215
+ }
216
+ nameToDir.set(name, dir);
217
+ };
218
+ const hasContent = (f) => (f.tables?.length ?? 0) > 0 ||
219
+ !!f.actionFiles ||
220
+ !!f.featureLibFiles ||
221
+ (f.pageFiles?.length ?? 0) > 0 ||
222
+ !!f.resourceSource;
223
+ /** Fail-closed check for unreserved subdirs of a NON-area feature. */
224
+ const checkUnloadedSubdirs = async (featureName, dir) => {
225
+ const entries = await readdirSorted(dir);
226
+ for (const entry of entries.filter((e) => e.isDirectory())) {
227
+ if (RESERVED_FEATURE_SUBDIRS.has(entry.name))
228
+ continue;
229
+ const nested = await walkRecursiveTs(join(dir, entry.name), entry.name);
230
+ const files = Object.entries(nested);
231
+ if (files.length === 0)
232
+ continue;
233
+ const withDefs = files.filter(([, src]) => src.includes('defineTable(') || src.includes('defineAction('));
234
+ if (withDefs.length > 0) {
235
+ throw new Error(`feature "${featureName}" contains subdirectory "${entry.name}/" with .ts files ` +
236
+ `declaring defineTable(...)/defineAction(...) that are NOT loaded ` +
237
+ `(${withDefs.map(([p]) => p).join(', ')}). Nested features are only loaded under an ` +
238
+ `AREA folder — add ${join(dir, '_area.ts')} (export default defineArea({...})) if ` +
239
+ `you meant an area, or move the files into the feature root / actions/.`);
240
+ }
241
+ console.warn(`feature "${featureName}" contains subdirectory "${entry.name}/" with .ts files that ` +
242
+ `are not loaded. If you meant an area, add ${join(dir, '_area.ts')}.`);
243
+ }
244
+ };
245
+ const loadAreaNode = async (dirPath, dir) => {
246
+ const areaFilePath = join(dir, '_area.ts');
247
+ const module = await loadTypeScriptFile(areaFilePath);
248
+ const definition = module.default;
249
+ if (!definition || typeof definition !== 'object' || Array.isArray(definition)) {
250
+ throw new Error(`features/${dirPath.join('/')}/_area.ts: expected a default export of defineArea({...}).`);
251
+ }
252
+ areas.push({ dirPath, definition: definition });
253
+ };
254
+ const walk = async (dir, areaPath) => {
255
+ const entries = await readdirSorted(dir);
256
+ const childDirs = entries
257
+ .filter((d) => d.isDirectory())
258
+ .map((d) => d.name)
259
+ .filter((name) => !(areaPath.length > 0 && RESERVED_FEATURE_SUBDIRS.has(name)));
260
+ for (const name of childDirs) {
261
+ const childDir = join(dir, name);
262
+ // Authored source dir relative to featuresDir, POSIX-normalized. This is
263
+ // the exact on-disk location — NOT `featuresDir/name` — so area-nested
264
+ // actions are looked up where they actually live. For an area folder that
265
+ // is itself a feature this is just `<area>` (never `<area>/<area>`).
266
+ const sourceDir = relative(featuresDir, childDir).split(sep).join('/');
267
+ const isArea = await pathExists(join(childDir, '_area.ts'));
268
+ if (isArea) {
269
+ const dirPath = [...areaPath, name];
270
+ await loadAreaNode(dirPath, childDir);
271
+ // The area folder may itself also be a feature (root tables + actions/).
272
+ const asFeature = await loadFeature(name, childDir);
273
+ if (asFeature) {
274
+ asFeature.feature.areaPath = dirPath;
275
+ asFeature.feature.sourceDir = sourceDir;
276
+ if (hasContent(asFeature.feature) || asFeature.conflicts.length > 0) {
277
+ registerName(name, childDir);
278
+ loaded.push(asFeature);
279
+ }
280
+ }
281
+ await walk(childDir, dirPath);
282
+ continue;
283
+ }
284
+ const result = await loadFeature(name, childDir);
285
+ if (!result)
286
+ continue;
287
+ if (areaPath.length > 0)
288
+ result.feature.areaPath = [...areaPath];
289
+ result.feature.sourceDir = sourceDir;
290
+ registerName(name, childDir);
291
+ loaded.push(result);
292
+ if (result.conflicts.length === 0) {
293
+ await checkUnloadedSubdirs(name, childDir);
294
+ }
295
+ }
296
+ };
297
+ await walk(featuresDir, []);
206
298
  // Surface every retired-shape conflict in one batched error block — saves
207
299
  // users a "fix one, recompile, fix the next" papercut loop.
208
300
  const allConflicts = loaded.flatMap((f) => f.conflicts);
@@ -211,7 +303,7 @@ export async function loadFeatures(featuresDir) {
211
303
  throw new Error(`Action discovery found ${allConflicts.length} conflict(s):\n${lines.join('\n')}\n\n` +
212
304
  `Resolve all of the above and recompile.`);
213
305
  }
214
- return loaded.map((f) => f.feature);
306
+ return { features: loaded.map((f) => f.feature), areas };
215
307
  }
216
308
  /**
217
309
  * Recursively walk a directory and collect every `.ts` file as
@@ -272,8 +364,11 @@ async function loadFeature(name, dir) {
272
364
  const conflicts = [];
273
365
  const migrate = (msg) => `${msg} See https://docs.quickback.dev/compiler/definitions/actions for the new shape.`;
274
366
  // ── Reject retired root-level files / colocated `defineActions(` ────────────
367
+ // `_area.ts` is the area node file (feature areas) — excluded here so the
368
+ // area-folder-as-feature case never sweeps it through the retired-shape
369
+ // checks or table discovery.
275
370
  const rootEntries = await readdirSorted(dir);
276
- const rootTsFiles = rootEntries.filter((e) => e.isFile() && e.name.endsWith('.ts'));
371
+ const rootTsFiles = rootEntries.filter((e) => e.isFile() && e.name.endsWith('.ts') && e.name !== '_area.ts');
277
372
  for (const entry of rootTsFiles) {
278
373
  if (entry.name === 'actions.ts') {
279
374
  conflicts.push({
@@ -288,7 +383,8 @@ async function loadFeature(name, dir) {
288
383
  conflicts.push({
289
384
  feature: name,
290
385
  message: migrate('`_feature.ts` is retired. Move shared schemas/helpers to `<feature>/lib/` and tableless ' +
291
- 'actions to `actions/<name>.ts`.'),
386
+ 'actions to `actions/<name>.ts`. (If you meant a feature AREA — shared authz for a ' +
387
+ 'folder of features — the file is `_area.ts` with `export default defineArea({...})`.)'),
292
388
  paths: [join(dir, '_feature.ts')],
293
389
  });
294
390
  continue;
@@ -407,6 +503,7 @@ async function loadFeatureTables(name, dir) {
407
503
  const entries = await readdirSorted(dir);
408
504
  const files = entries.filter((e) => e.isFile() &&
409
505
  e.name.endsWith('.ts') &&
506
+ e.name !== '_area.ts' && // area node file, never a table candidate
410
507
  !RETIRED_FILENAME_PATTERNS.some((re) => re.test(e.name)));
411
508
  // Use index-based results to preserve deterministic file ordering
412
509
  const results = new Array(files.length);