@getstrata/cli 3.0.7 → 3.1.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 +5 -506
- package/README.md +15 -78
- package/package.json +3 -3
- package/src/commands/help.ts +5 -0
- package/src/scaffold/index.ts +3 -0
- package/src/scaffold/makeController.ts +32 -0
- package/src/scaffold/makeFactory.ts +16 -4
- package/src/scaffold/makeModel.ts +15 -18
- package/src/scaffold/makeModule.ts +1 -1
- package/src/scaffold/makePolicy.ts +28 -48
- package/src/scaffold/makeRequest.ts +25 -55
- package/src/scaffold/renderModule.ts +47 -68
- package/src/scaffold/scaffoldFile.ts +3 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,511 +1,10 @@
|
|
|
1
1
|
# @getstrata/cli changelog
|
|
2
2
|
|
|
3
|
-
## 3.0
|
|
3
|
+
## 3.1.0
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
- Generate concise model classes and infer factory/record types without table, interface or repository companion files.
|
|
6
|
+
- Add `make:controller`; align requests and policies with `src/http/requests` and `src/policies`. Optional domain modules emit named controllers and retain secured CRUD, cache and route-model-binding behavior.
|
|
6
7
|
|
|
7
|
-
## 3.0.
|
|
8
|
+
## 3.0.8
|
|
8
9
|
|
|
9
|
-
|
|
10
|
-
- Simplify module scaffolds to models, controllers, requests and policies without forwarding service/repository/provider layers. Honor the configured modules directory.
|
|
11
|
-
- Generate factories in `src/db/factories`, resolve existing standalone or module record types, support nested model names and reject missing models before writing files.
|
|
12
|
-
- Validate scaffold names/paths before filesystem changes and keep per-command help free of file-writing side effects. Generate migrations through `defineMigration`.
|
|
13
|
-
- Share captured configuration across migration, seeding and reset commands, including the production reset guard.
|
|
14
|
-
- Align CLI peer dependencies and generated application pins with core/bootstrap 3.0.6.
|
|
15
|
-
|
|
16
|
-
**Upgrade:** Review generated module/factory layouts and adopt the packaged application command configuration. Applications using removed test helpers should use the dedicated testing entrypoints. See [the release notes](../../docs/releases/3.0.6.md) and [application authoring changes](../../docs/architecture/application-dx-convergence.md).
|
|
17
|
-
|
|
18
|
-
## 3.0.5
|
|
19
|
-
|
|
20
|
-
- Fixed SQLite queries returning no rows when SQL begins with comments, including VALUES, PRAGMA, EXPLAIN, and compact RETURNING statements.
|
|
21
|
-
- Aligned memory and Redis cache expiration. Added put and forever to ordinary, tagged, and execution-scoped caches. Zero or negative TTLs now remove entries; invalid numeric TTLs are rejected before effects.
|
|
22
|
-
- Fixed stale cache loaders overwriting newer writes and empty cache keys bypassing memory limits.
|
|
23
|
-
- Fixed internal redirect validation bypasses and preserved repeated query parameters.
|
|
24
|
-
- Fixed malformed intended-URL and flash cookies throwing errors.
|
|
25
|
-
- Fixed CI package dry-runs failing when the package version was already published.
|
|
26
|
-
|
|
27
|
-
**Migration:** Replace Redis TTL 0 used for permanent storage with forever(). For a permanent configured default, use . TTL units remain milliseconds.
|
|
28
|
-
|
|
29
|
-
## 3.0.4
|
|
30
|
-
|
|
31
|
-
Restore workspace-based npm publication and remove custom archive packing/recovery. Skip confirmed existing versions, stop on registry lookup failures, and accept successful npm uploads without requiring immediate registry visibility. Retain release quality gates, pinned npm, provenance and publication dry-runs. The v3.0.3 attempt published only @getstrata/core before its visibility check failed.
|
|
32
|
-
|
|
33
|
-
## 3.0.3
|
|
34
|
-
|
|
35
|
-
Remove the separate successful-main-CI prerequisite; the release workflow still requires its own full quality gate before publication.
|
|
36
|
-
|
|
37
|
-
Fix npm publication of local release archives by resolving paths absolutely, avoiding GitHub shorthand interpretation. Exercise archive publication dry-runs in CI and before live publication. Preserve the failed v3.0.2 tag; its first publish failed before any package was published.
|
|
38
|
-
|
|
39
|
-
## 3.0.2
|
|
40
|
-
|
|
41
|
-
Reconcile completed framework ownership and retirement documentation. Clarify the exact-commit main CI prerequisite, early-tag retry procedure, and maintainer release handoff; improve the release admission diagnostic without changing its checks.
|
|
42
|
-
|
|
43
|
-
Remove unused internal renderer/build compatibility helpers and migrate their test imports. Refresh v3 application, auth, discovery, queue, tracing and lifecycle guidance; clearly label retained 2.x qualification evidence.
|
|
44
|
-
|
|
45
|
-
## 3.0.1
|
|
46
|
-
|
|
47
|
-
Fix release archive packing for npm 12 package-keyed JSON output while retaining npm 11 compatibility. Validate archive identity and integrity, pin the publication toolchain, and exercise actual release packing in CI. The v3.0.0 tag remains unchanged; its failed workflow published no npm packages.
|
|
48
|
-
|
|
49
|
-
## 3.0.0
|
|
50
|
-
|
|
51
|
-
Breaking application-owned runtime, typed authorization and persistence, immutable starter plans, isolated adapters and authenticated queue handoffs.
|
|
52
|
-
|
|
53
|
-
## 2.2.60
|
|
54
|
-
|
|
55
|
-
- Align published core/bootstrap peers with 2.2.60. Failed-job operations receive the core persistence correction; CLI commands and replay admission/deletion ordering are unchanged.
|
|
56
|
-
|
|
57
|
-
## 2.2.59
|
|
58
|
-
|
|
59
|
-
- Align core/bootstrap dependencies with 2.2.59. Existing model/view commands retain their behavior and benefit from the corrected public model typing.
|
|
60
|
-
- Generated application files remain app-owned. Package upgrades do not rewrite migration helpers/status entrypoints or remove an application's explicit schema-only migration command.
|
|
61
|
-
|
|
62
|
-
## 2.2.58
|
|
63
|
-
|
|
64
|
-
PostgreSQL runtime privilege fix: Replace broad table/sequence grants with explicit CRUD and sequence usage/read permissions. Repair legacy helper-managed grants that allowed TRUNCATE across RLS tenant boundaries. Preserve provisioning locks and transactional rollback. Resolves #364 through #370.
|
|
65
|
-
UUID schema columns: Add table.uuid() with PostgreSQL native UUID, MySQL CHAR(36) and SQLite TEXT. Supports explicit constraints and application-supplied identifiers; existing schemas remain unchanged. #365
|
|
66
|
-
Model and view generators: Add make:model for declarative models with automatic repositories, and make:view for escaped Eta templates. Support nested names and explicit model metadata, with path validation and overwrite protection. Migrations remain explicit and separate. #368
|
|
67
|
-
Repeated form values: Add opt-in { preserveRepeated: true } parsing through core form helpers and WebFormRequest, retaining repeated text and files in order. Existing parsing defaults remain unchanged; applications retain responsibility for duplicate validation. #366
|
|
68
|
-
Mail extension documentation and coverage: Qualify existing injected MailDriver integrations, including HTTPS providers, cancellation, deadlines, error propagation and provider-controlled idempotency. This adds tests and guidance without changing stock mail transports. #367
|
|
69
|
-
|
|
70
|
-
## 2.2.57
|
|
71
|
-
|
|
72
|
-
Align the CLI with the compatible 2.2.57 core/bootstrap runtime. No new command or implicit proxy trust is introduced.
|
|
73
|
-
|
|
74
|
-
## 2.2.56
|
|
75
|
-
|
|
76
|
-
- Require Bun >=1.4.4 and align core/bootstrap dependencies with 2.2.56. Existing application-owned generated files and database ACLs still require explicit reviewed adoption; package installation does not rewrite source or revoke privileges.
|
|
77
|
-
|
|
78
|
-
## 2.2.55
|
|
79
|
-
|
|
80
|
-
- Align core/bootstrap requirements with 2.2.55. Dependency upgrades do not rewrite application-owned generated source.
|
|
81
|
-
|
|
82
|
-
## 2.2.54
|
|
83
|
-
|
|
84
|
-
- Align core/bootstrap requirements with 2.2.54. Package upgrades do not rewrite application-owned generated source.
|
|
85
|
-
|
|
86
|
-
## 2.2.53
|
|
87
|
-
|
|
88
|
-
- Align core/bootstrap requirements with 2.2.53. Existing application-owned generated sources are not rewritten by package upgrades.
|
|
89
|
-
|
|
90
|
-
## 2.2.52
|
|
91
|
-
|
|
92
|
-
- Align core/bootstrap package requirements with 2.2.52. Existing generated application sources are not rewritten by package upgrades.
|
|
93
|
-
|
|
94
|
-
## 2.2.51
|
|
95
|
-
|
|
96
|
-
- Align core/bootstrap pins with 2.2.51; command and generated module behavior unchanged. Existing generated sources are not rewritten.
|
|
97
|
-
|
|
98
|
-
## 2.2.50
|
|
99
|
-
|
|
100
|
-
- Align framework package pins with 2.2.50. CLI commands and emitted module behavior are unchanged.
|
|
101
|
-
|
|
102
|
-
## 2.2.49
|
|
103
|
-
|
|
104
|
-
- Align core/bootstrap requirements with the 2.2.49 compatible HTTP, model and runtime correction batch. Existing module generation and permission boundaries remain unchanged.
|
|
105
|
-
- Installing the CLI does not rewrite existing application-owned generated sources.
|
|
106
|
-
|
|
107
|
-
## 2.2.48
|
|
108
|
-
|
|
109
|
-
- Separate pure module rendering from filesystem orchestration while retaining generated file paths and behavior.
|
|
110
|
-
- Preserve generated model-bound `id` request contracts through the existing generic kernel wrappers; remove four generated double casts and explicitly type show/delete requests. Existing generated application files are not rewritten by installing the new CLI.
|
|
111
|
-
- Align bootstrap/core peer requirements with 2.2.48.
|
|
112
|
-
|
|
113
|
-
## 2.2.47
|
|
114
|
-
|
|
115
|
-
- Keep companion module API routes under API_PREFIX and HTML routes separate; render through the public namespaced ViewRenderer with layout data and HTMX handling. Plain module paths remain unchanged.
|
|
116
|
-
- Generate services against current ORM updateByIdOrThrow/deleteById APIs with explicit HTTP not-found mapping.
|
|
117
|
-
- Exercise installed CLI scaffolding, generated-app typechecking, API-only OpenAPI, permission boundaries and real scoped CRUD across SQLite, MySQL and PostgreSQL.
|
|
118
|
-
|
|
119
|
-
## 2.2.46
|
|
120
|
-
|
|
121
|
-
- Align published runtime and starter dependency pins with the 2.2.46 generated-app contracts.
|
|
122
|
-
|
|
123
|
-
## 2.2.45
|
|
124
|
-
|
|
125
|
-
Offer optional Adminer consistently in Docker and Mix wizard modes when the selected database is in Compose. Generate debug-profile startup commands and complete database login instructions; correct noninteractive Docker documentation while preserving existing flag behavior. Add prompt/CLI regressions and real isolated MySQL/Postgres Adminer profile and login acceptance tests without removing assertions.
|
|
126
|
-
|
|
127
|
-
## 2.2.44
|
|
128
|
-
|
|
129
|
-
Generate JSON registration, verification/resend, reset and password-confirmed MFA for API/SPA cookie starters; share guarded MFA persistence with HTML, reject malformed TOTP secrets, and extend installed-app SMTP, replay, revocation and compiler coverage without changing HTML contracts.
|
|
130
|
-
|
|
131
|
-
Preserve private/no-store headers when the tenancy boundary maps an HTTP error to JSON, without changing its status/body or transaction rollback. Rebuild the starter in standalone generated-app verification to prevent stale output from producing false green results.
|
|
132
|
-
|
|
133
|
-
Honor the explicit API JSON error context during password confirmation even when a client sends HTML/HTMX headers; preserve automatic HTML behavior outside that context.
|
|
134
|
-
|
|
135
|
-
Use the shared JSON parser for signed password reset so malformed input is a controlled 400 and does not consume the reset proof.
|
|
136
|
-
|
|
137
|
-
## 2.2.43
|
|
138
|
-
|
|
139
|
-
Add `afterCommit` for process-local effects after the outermost managed transaction, sharing savepoint rollback and tenant replay with model events. Generated auth SMTP uses this boundary even inside RLS request transactions; callback failures propagate after commit without undoing persisted accounts. Durable delivery still requires the SQL outbox.
|
|
140
|
-
|
|
141
|
-
Fix MySQL verification/reset and session-revocation timestamps through the shared SQL dialect; make signup account and verification-token persistence atomic with SMTP after commit; initialize no-tenancy seed connections; add installed starter auth/SMTP/MFA/rollback journeys for every database and frontend, plus generated TypeScript profiles.
|
|
142
|
-
|
|
143
|
-
## 2.2.42
|
|
144
|
-
|
|
145
|
-
Generate auth JSON and forms with explicit private, no-store cache policy. Add privateJsonResponse and typed view namespace header defaults while preserving normal public defaults, native cookies, per-response overrides and HTMX representation behavior. Cover packed APIs and actual generated cookie/token/JWT/CSRF/profile/form HTTP responses.
|
|
146
|
-
|
|
147
|
-
Use the canonical error serializer for core JSON admission denials so authentication, policy/admin/ability, verification, password confirmation and body-limit failures retain no-store. Preserve exact status/message contracts, keep checker details private and retain HTML redirects/throws and successful response headers. Add packed producer regressions and a native detail-projection case.
|
|
148
|
-
|
|
149
|
-
## 2.2.41
|
|
150
|
-
|
|
151
|
-
Make framework HTML/JSON error responses non-storeable, including configured/fallback renderers and custom-body 404 responses; retain success-response cache policy and add packed header regressions.
|
|
152
|
-
|
|
153
|
-
Fix packaged error wrappers ignoring the configured application error renderer; preserve API JSON precedence and add packed configured/default rendering regressions.
|
|
154
|
-
|
|
155
|
-
Fix packaged membership middleware and default service ignoring the configured application lookup. Use the canonical membership context while preserving explicit service injection and request isolation. Add mandatory packed external-app coverage for concurrent users, replacement configuration and propagated lookup failures.
|
|
156
|
-
|
|
157
|
-
## 2.2.40
|
|
158
|
-
|
|
159
|
-
Fix shared DNS fixture state in packaged outbound consumers. safeFetch and GitHub OAuth now use the canonical safeUrl resolver while retaining DNS pinning, private-address validation and request deadlines. Add mandatory packed external-app regressions for resolver replacement and private-target refusal; document controlled-provider qualification limits.
|
|
160
|
-
|
|
161
|
-
## 2.2.39
|
|
162
|
-
|
|
163
|
-
Fix published HTTP metrics registry identity: share root/subpath Prometheus state and preserve registry, class and bucket exports. Keep generated middleware/exporter observations consistent and extend installed Postgres/SQLite/MySQL HTTP regressions; no app bridge, schema change or collector-policy change.
|
|
164
|
-
|
|
165
|
-
## 2.2.38
|
|
166
|
-
|
|
167
|
-
Qualify packed OIDC and SAML callbacks across Postgres, SQLite and MySQL. Fix explicitly non-migrating local bootstrap provisioning, dialect-safe transactional SAML replay, verified bearer ACS recipient binding, and independent SAML Response Destination validation through a maintained parser. Fix owned listener/client address mismatches with typed generated native options and optional CLI HOST, retaining default production binding. Preserve existing generated auth, production guards, compiler/runtime assertions and coverage gates; live provider and deployment qualification remain separate.
|
|
168
|
-
|
|
169
|
-
## 2.2.37
|
|
170
|
-
|
|
171
|
-
Fix MySQL repository entity-returning mutations with transaction-pinned readback, persisted keys/defaults, honest null and deletion outcomes, complete model event payloads and injected connection ownership. Preserve native Postgres/SQLite RETURNING and conditional affected-row metadata. Close owned generated OpenAPI and failed-job command applications on success and failure before exit; retain both command and cleanup errors. Add mandatory packaged MySQL production column-tenancy CLI and HTTP auth/SCIM acceptance with an owned DML-only account, unchanged route/spec/SDK contracts, native ORM regressions and cleanup tests. Records dogfood issues #232 and #233 without application SQL workarounds.
|
|
172
|
-
|
|
173
|
-
## 2.2.36
|
|
174
|
-
|
|
175
|
-
Add a mandatory installed-package SQLite column-tenancy CLI/OpenAPI/HTTP profile, including cookie/token/JWT/Basic and repeated SCIM isolation, while preserving existing Postgres security, route inventories, compiler combinations and Docker gates. Reconcile observability/rotation trackers against shipped capabilities and remaining operational qualification.
|
|
176
|
-
|
|
177
|
-
Fix declared default exports missing from nine published core subpaths. Preserve defaults in generated non-shared entries and alias the shared BaseRepository default to its canonical root constructor, retaining named exports and singleton/class identity. Extend declaration/runtime verification with value-default and type-only-default regressions; compile all nine imports across the existing 18 generated compiler combinations and execute them in every installed candidate app. Records the published 2.2.35 reproduction from Q01 dogfooding; no shop adapter or node_modules patch.
|
|
178
|
-
|
|
179
|
-
## 2.2.35
|
|
180
|
-
|
|
181
|
-
Retire checked-in HiroApp applications after preserving security, CLI/OpenAPI/HTTP, source, migration and Docker acceptance in generated candidate-package fixtures. Keep all 23 security cases, 40 runtime operations, 22 API/protocol operations, three-engine migration cases and 18 compiler combinations. Make the private root CLI fixture-only, isolate post-commit HTTP databases, and validate the generated production image with restricted runtime credentials, Redis recovery and graceful shutdown. Remove obsolete app regeneration/selectors and update contributor, generator and deployment documentation; retain compatible example preset IDs and explicit application-owned deployment boundaries. Regenerate the sample SDK from the API-only snapshot and verify it against the installed candidate package. Core coverage retains 136 enforced files at 100%; remove only the two deleted private-entrypoint exemptions (272 remaining).
|
|
182
|
-
|
|
183
|
-
## 2.2.34
|
|
184
|
-
|
|
185
|
-
Complete opt-in persisted account-state adoption: atomic SCIM suspension/reactivation and credential revocation, serialized generated password/SSO issuance, version-bound session/MFA/confirmation proofs, safe optional credential-table handling and malformed-cookie rejection. Includes explicit schema migration and upgrade instructions; installing packages alone does not rewrite existing apps.
|
|
186
|
-
|
|
187
|
-
Compatibility release aligning CLI peers and packaged scaffolding with the completed account-state contracts. No automatic application rewrite, migration, demo seeding or package publication is performed by installing this release.
|
|
188
|
-
|
|
189
|
-
## 2.2.33
|
|
190
|
-
|
|
191
|
-
Fix shared tenant lookups in generated SQLite column-tenancy apps through typed repositories. Generated SCIM rejects unsupported status/profile mutations before writing and runs mutations in explicit transactions, including immediate observer rollback. Add actual SQLite and restricted Postgres HTTP regressions; full account deactivation remains unsupported and explicit.
|
|
192
|
-
|
|
193
|
-
## 2.2.32
|
|
194
|
-
|
|
195
|
-
Generated JSON and HTML email verification now atomically consumes the one-time link with the account update and immediate observers, including SQLite/non-RLS apps. Failed verification remains retryable. Adds actual signed HTTP rollback, purpose/expiry/admission, concurrency and replay regressions while preserving existing response contracts.
|
|
196
|
-
|
|
197
|
-
## 2.2.31
|
|
198
|
-
|
|
199
|
-
Preserve JWT issuance precision across millisecond revocation cutoffs without changing expiration. Generated MFA setup rejects stale concurrent state changes and atomically commits credential revocation in SQLite/non-RLS as well as Postgres RLS. Adds real HTTP initial/replacement races, revocation rollback and withheld-success recovery regressions; intentional fresh replacement remains supported.
|
|
200
|
-
|
|
201
|
-
## 2.2.30
|
|
202
|
-
|
|
203
|
-
Basic authentication resolution is reused only within the same Request and unchanged credentials, preventing middleware/controller lookups from consuming MFA recovery proofs twice. Adds real HTTP replay/concurrency and credential/guard invalidation regressions.
|
|
204
|
-
|
|
205
|
-
## 2.2.29
|
|
206
|
-
|
|
207
|
-
MFA recovery-code persistence atomically claims the validated snapshot and rejects stale requests before credential issuance. Basic authentication fails closed and consumes under the verified RLS identifier scope. Adds native SQLite/Postgres/MySQL concurrency and restricted-role regressions.
|
|
208
|
-
|
|
209
|
-
## 2.2.28
|
|
210
|
-
|
|
211
|
-
Generated JSON and HTML password resets validate input before consuming signed links and atomically commit token consumption, password updates and credential revocation. Adds real generated-app failure, retry, replay and cookie/token/JWT revocation regressions.
|
|
212
|
-
|
|
213
|
-
## 2.2.27
|
|
214
|
-
|
|
215
|
-
Storage distinguishes missing objects from filesystem, authorization, missing-bucket and transport failures; S3 reads use a single native GET. Adds native Bun protocol regressions and documents failure/reconciliation contracts.
|
|
216
|
-
|
|
217
|
-
## 2.2.26
|
|
218
|
-
|
|
219
|
-
Fix complete safe integer validation with optional strict JSON-number input; add scoped read-only outbox delivery inspection; add typed grouped sums with exact textual totals, protected predicates and dialect/RLS regressions.
|
|
220
|
-
|
|
221
|
-
## 2.2.25
|
|
222
|
-
|
|
223
|
-
Queue worker run loops recover native Redis connection closure with bounded backoff and a fresh connection. Uncertain Redis mutations are not replayed; retained reservations and retries use normal recovery. Explicit closure remains terminal and non-connection errors remain fatal. Native poll/ack closure regressions cover Streams and list transports.
|
|
224
|
-
|
|
225
|
-
## 2.2.24
|
|
226
|
-
|
|
227
|
-
Fix Redis cache recovery after transport failures and command deadlines: retire failed connections, abort active fills, and lazily reconnect for later operations without replaying uncertain commands; preserve permanent explicit closure and shared invalidation fencing.
|
|
228
|
-
|
|
229
|
-
## 2.2.23
|
|
230
|
-
|
|
231
|
-
Fix native SMTP hangs with bounded whole-send deadlines, cancellation, buffered multiline replies, complete writes and verified implicit TLS. Preserve known final DATA acceptance through cleanup failures. Correct DATA transparency, CRLF, UTF-8 MIME/header encoding and long-line framing; reject incomplete AUTH and unsupported SMTPUTF8 envelopes explicitly. Generate documented SMTP timeout and TLS defaults. Real socket/TLS/protocol regressions cover outages, cancellation, accepted sends and framing; SMTP delivery before final acknowledgement remains uncertain.
|
|
232
|
-
|
|
233
|
-
## 2.2.22
|
|
234
|
-
|
|
235
|
-
Preserve caller auth, credential sources, request metadata and application async stores through cold/queued native transaction callbacks. Serialize Postgres privilege grants with full provisioning using atomic database-scoped batches, retaining delegated-admin permissions and rollback/retry safety. Add real constrained-pool JSON/HTML bearer/session-CSRF and concurrent grant/atomicity regressions; no automatic workers, auth bypass or production runtime provisioning.
|
|
236
|
-
|
|
237
|
-
## 2.2.21
|
|
238
|
-
|
|
239
|
-
Make registered queue/outbox workers discoverable in CLI help and generated startup guidance. Announce polling after boot and when it stops without claiming dependency health, printing secrets, or starting workers automatically. Preserve explicit process ownership, delivery semantics and graceful lifecycle; cover idle, boot/runtime/cleanup failures and real SIGTERM draining.
|
|
240
|
-
|
|
241
|
-
## 2.2.20
|
|
242
|
-
|
|
243
|
-
Validate complete migration definitions before callbacks, locks or database effects; reject malformed exports and duplicate names with source diagnostics. Refuse fresh with missing applied definitions and rollback with incomplete latest batches; preserve partial forward migration and remove blanket history deletion. Cover physical schema/data/history preservation and reset recovery on real Postgres, MySQL and SQLite, plus loader and preflight regressions; document safe missing-file recovery and unchanged atomicity limits.
|
|
244
|
-
|
|
245
|
-
## 2.2.19
|
|
246
|
-
|
|
247
|
-
Fix explicit development fresh resets with unfinished outbox deliveries while preserving ordinary rollback guards. Record each completed reset down immediately so later refusal leaves recoverable migration progress; document partial-DDL/crash limits and old-history reconciliation. Add independent outbox-state and reset failure/migrate/retry regressions on real Postgres, MySQL and SQLite, history-write/reapplication fault injection, and a documented stateful regression review flow.
|
|
248
|
-
|
|
249
|
-
## 2.2.18
|
|
250
|
-
|
|
251
|
-
Add optional typed guardMigrationRollback for application-owned rollback history predicates; skip history reads only during explicit development fresh resets, propagate predicate failures, and reuse the contract for encryption-checkpoint archival protection. Document guard placement and unchanged reset/rollback safety; cover type, runner and real SQLite history regressions.
|
|
252
|
-
|
|
253
|
-
## 2.2.17
|
|
254
|
-
|
|
255
|
-
Add explicit development-only migration reset context while preserving guarded rollback and encryption archival; align generated fresh entries and reject production/staging or unsupported reset arguments before provisioning. Replace CSP-blocked error-page JavaScript navigation with safe same-origin links, and correct ambiguous Postgres/SQLite foreign-key messages without changing their HTTP status.
|
|
256
|
-
|
|
257
|
-
## 2.2.16
|
|
258
|
-
|
|
259
|
-
Allow managed outbox workers to reuse a configured instance, preserving application tenant resolution, listener registration and delivery settings. Keep generated listeners-only defaults compatible, reject ambiguous worker sources, and cover configured SQL delivery, cancellation, cleanup and TypeScript contracts.
|
|
260
|
-
|
|
261
|
-
## 2.2.15
|
|
262
|
-
|
|
263
|
-
- Batch legacy list-queue priority polling while retaining recovery and ownership contracts.
|
|
264
|
-
- Batch dialect-portable pivot writes with framework transaction/savepoint composition and consistent numeric/string ID toggle semantics. Noncanonical or textual IDs use sequential database comparisons to preserve coercion and collation behavior.
|
|
265
|
-
- New Redis scaffolds explicitly select Streams; existing unset transport settings continue to select lists.
|
|
266
|
-
- Generate the SQL outbox migration, listener registry and managed worker command. Durable publication and cache-invalidation activation remain explicit.
|
|
267
|
-
|
|
268
|
-
- Primary-key ascending `chunk` queries reuse the existing keyset walk, including default primary-key ordering; projections, joins, grouping, locks and other orders retain OFFSET behavior.
|
|
269
|
-
- Empty filtered pagination totals skip the row query. Nonempty page-number pagination preserves OFFSET semantics and its count-plus-row-query budget; explicit cursor/keyset APIs remain available for deep traversal.
|
|
270
|
-
- Independent hashed write casts run concurrently. Deterministic regressions prove concurrent start, complete awaiting and failure before model observers or SQL writes; hydration and existing-hash behavior are preserved.
|
|
271
|
-
- Streams workers poll retry promotion, pending recovery and new delivery across priorities in one bounded Redis script, preserving priority, ownership fencing and at-least-once delivery contracts.
|
|
272
|
-
- Clarify historical 2.1.0–2.2.13 release notes and database/queue documentation. Remove the consolidated 1.x-to-2.x migration guide; existing projects are upgraded individually.
|
|
273
|
-
|
|
274
|
-
## 2.2.14
|
|
275
|
-
|
|
276
|
-
Complete the scoped HTML rendering starter adoption: generated apps inject ViewRenderer through createViewProvider instead of copying renderPage; welcome pages opt into HTMX fragments with full-page fallbacks, auth retains existing contracts, and CORS preserves representation Vary headers. Includes generator, runtime auth and cache-header regressions.
|
|
277
|
-
|
|
278
|
-
Add optional typed resourceRoutes and strict mergeRouteMaps composition, preserving native Bun routing and app-owned middleware. Add explicit ViewRenderer.namespace prefixes with unchanged layout/Response/HTMX contracts; generated auth controllers use the namespace. Includes native HTTP, compile-time, rendering isolation and generator regressions.
|
|
279
|
-
|
|
280
|
-
## 2.2.13
|
|
281
|
-
|
|
282
|
-
- Add a typed per-app HTML renderer on top of the native response path.
|
|
283
|
-
- Add explicit HTMX page and fragment responses. A fragment can fall back to the full page. Layout and auth response contracts stay the same.
|
|
284
|
-
|
|
285
|
-
## 2.2.12
|
|
286
|
-
|
|
287
|
-
- Require Bun >=1.4.3; align CI, generated/existing example runtime pins and Docker stages to 1.4.3, with bun-types >=1.4.3 behind the official @types/bun shim.
|
|
288
|
-
|
|
289
|
-
Add identified field-encryption keyrings, reader-first email/MFA configuration, and explicit transactional maintenance rotation for ciphertext and lookup keys with durable checkpoints, RLS scopes, fresh retirement audits and backup/rollback guidance. Fix SQLite primary-key compilation for non-generated keys. Preserve legacy auth defaults; no automatic data migration.
|
|
290
|
-
|
|
291
|
-
## 2.2.11
|
|
292
|
-
|
|
293
|
-
Add independently interruptible read-only SQLite and MySQL observations; extend bounded failed-job and outbox metrics to file-backed SQLite and URL-backed MySQL with schema/index guards, real-engine regressions and three-process consistency tests. Preserve Postgres RLS and business transaction behavior.
|
|
294
|
-
|
|
295
|
-
## 2.2.10
|
|
296
|
-
|
|
297
|
-
- Add bounded OpenTelemetry SDK health observations and selected native transaction-acquisition histograms through explicit metrics options.
|
|
298
|
-
- Add bounded Postgres failed-job counts using ORM ID projections, with schema guards, native acquisition deadlines and read-only collector draining.
|
|
299
|
-
- Observe Streams retry promotion lateness using Redis time; cancellation cleanup sentinels omit unavailable age instead of reporting age since epoch.
|
|
300
|
-
- Generate typed runtimeMetrics opt-in and provider-owned SQL collector draining, including startup cleanup; HTTP-only defaults and borrowed tracing ownership remain intact.
|
|
301
|
-
- Keep additional SQL observation dialects, sustained operational qualification and encryption rotation explicit follow-up work.
|
|
302
|
-
|
|
303
|
-
## 2.2.9
|
|
304
|
-
|
|
305
|
-
- Pool checkout can be cancelled. `reserve({ signal })` on the native driver aborts while it is still waiting for a connection. Drivers without that method are not given a fake one.
|
|
306
|
-
|
|
307
|
-
## 2.2.8
|
|
308
|
-
|
|
309
|
-
- Add bounded, read-only Postgres outbox metrics.
|
|
310
|
-
- Add bounded, opt-in Redis queue metrics. List and Streams depth stay separate.
|
|
311
|
-
|
|
312
|
-
## 2.2.7
|
|
313
|
-
|
|
314
|
-
- `ORDER BY` accepts explicit `nulls: "first" | "last"`. Postgres and SQLite emit `NULLS FIRST` / `NULLS LAST`. MySQL has no `NULLS FIRST` / `NULLS LAST` clause, so it orders nulls with an `IS NULL` discriminator and leaves the rest of the sort unchanged.
|
|
315
|
-
|
|
316
|
-
## 2.2.6
|
|
317
|
-
|
|
318
|
-
- The CLI, when it supervises the app or worker as a child, forwards shutdown signals to that child and waits for it. The container launcher no longer exits while the child is still running.
|
|
319
|
-
|
|
320
|
-
## 2.2.5
|
|
321
|
-
|
|
322
|
-
- Container readiness no longer means the API is admitting traffic. Database readiness no longer provisions roles or creates a missing database. A failed configured admin connection does not fall back to a generated password.
|
|
323
|
-
|
|
324
|
-
## 2.2.4
|
|
325
|
-
|
|
326
|
-
- Composite keyset pages on Postgres seek with a row comparison (`(a, b) > (cursor)`), so the planner can start at the index bound instead of expanding the cursor into a chain of OR predicates.
|
|
327
|
-
|
|
328
|
-
## 2.2.3
|
|
329
|
-
|
|
330
|
-
- Add scoped composite keyset pagination. The order must end with the primary key. Global scopes and caller filters stay in force across the cursor. Joins, grouping, and offset queries are rejected.
|
|
331
|
-
|
|
332
|
-
## 2.2.2
|
|
333
|
-
|
|
334
|
-
- Schema `bigId` emits an explicit 64-bit generated identity.
|
|
335
|
-
- Repository writes can be conditional and set-based.
|
|
336
|
-
- Repositories and models can take a typed row lock inside the current transaction.
|
|
337
|
-
- Generated Postgres query handles keep tagged-SQL typing.
|
|
338
|
-
|
|
339
|
-
## 2.2.1
|
|
340
|
-
|
|
341
|
-
- Opt-in Redis Streams (`QUEUE_REDIS_TRANSPORT=streams`). Lists stay the default. Streams adds consumer-group recovery, persisted retry schedules, total job deadlines, opt-in cancellation, and a stable job id across replay. Conversion from lists is a stopped maintenance step.
|
|
342
|
-
- Failed jobs stay recorded until retry admission succeeds. Manual replay keeps `failed_job.job_id` when the row has one.
|
|
343
|
-
- Public reads and tenant host selection are separate. Unknown hosts fail closed. Forwarded hosts are accepted only from configured trusted proxies.
|
|
344
|
-
- Generated apps can provision one initial administrator with `auth:provision-admin` and a one-time claim migration. Demo seeding stays explicit and is rejected in production and staging.
|
|
345
|
-
- Quota and in-memory throttle docs match the code: memory throttles stay process-local, and a Redis failure does not fall back to them.
|
|
346
|
-
|
|
347
|
-
## 2.2.0
|
|
348
|
-
|
|
349
|
-
Consistent model scopes.
|
|
350
|
-
Changed-field model writes.
|
|
351
|
-
Awaited provider startup.
|
|
352
|
-
Shared cache correctness.
|
|
353
|
-
Native HTTP controls and body limits.
|
|
354
|
-
Graceful lifecycle.
|
|
355
|
-
Validated async discovery.
|
|
356
|
-
Stronger model input types.
|
|
357
|
-
OpenTelemetry tracing.
|
|
358
|
-
Distributed scheduler ownership.
|
|
359
|
-
App-owned quota policy.
|
|
360
|
-
Bounded memory throttling.
|
|
361
|
-
|
|
362
|
-
## 2.1.0
|
|
363
|
-
|
|
364
|
-
- Generated apps reuse the shared config store and base repositories instead of a copied stack.
|
|
365
|
-
- Password casts are awaited before the write reaches SQL or observers. Hydration does not hash.
|
|
366
|
-
- Model queries keep the concrete model type in their results. Service tokens, route handlers, and the starter's generated infrastructure were tightened in the same release.
|
|
367
|
-
|
|
368
|
-
## 2.0.9
|
|
369
|
-
|
|
370
|
-
- fix(starter): remove demo credentials from public login defaults
|
|
371
|
-
|
|
372
|
-
## 2.0.8
|
|
373
|
-
|
|
374
|
-
- fix(schema): preserve constraints and generate builder migrations
|
|
375
|
-
|
|
376
|
-
## 2.0.7
|
|
377
|
-
|
|
378
|
-
- Fix concurrent Postgres role provisioning across databases
|
|
379
|
-
|
|
380
|
-
## 2.0.6
|
|
381
|
-
|
|
382
|
-
- Dispatch registered Bun route preflights through CORS
|
|
383
|
-
|
|
384
|
-
## 2.0.5
|
|
385
|
-
|
|
386
|
-
- Allow explicitly approved application headers in CORS
|
|
387
|
-
|
|
388
|
-
## 2.0.4
|
|
389
|
-
|
|
390
|
-
- Place cache rollout guidance beside outbox docs without overlapping API additions
|
|
391
|
-
|
|
392
|
-
## 2.0.3
|
|
393
|
-
|
|
394
|
-
- Persist transactional events with leased tenant-aware SQL outbox workers
|
|
395
|
-
|
|
396
|
-
## 2.0.2
|
|
397
|
-
|
|
398
|
-
- Adopt TypeScript 7.0.2 in framework and generated apps; preserve tested TypeScript 5.9 and 6.x consumer compatibility.
|
|
399
|
-
- Verify six generated app configurations against three compiler versions and typecheck/build React SPA and hybrid frontends.
|
|
400
|
-
- Declare Bun-supported CSS imports in the SPA scaffold for TypeScript 7.
|
|
401
|
-
|
|
402
|
-
## 2.0.1
|
|
403
|
-
|
|
404
|
-
- Fix release lockfile drift and CLI 2.x peer compatibility
|
|
405
|
-
|
|
406
|
-
## 2.0.0
|
|
407
|
-
|
|
408
|
-
- Strata 2.0: compose business transactions and tenant scopes
|
|
409
|
-
|
|
410
|
-
## Unreleased
|
|
411
|
-
|
|
412
|
-
- Await queue/scheduler application startup and close resources after failed startup or completed work; preserve original failures when cleanup also fails.
|
|
413
|
-
|
|
414
|
-
- 2.0: migrations no longer implicitly call an app seed export. Seeding requires --seed; fresh accepts the same explicit flag. Missing seed exports are rejected before applying migrations or resetting data.
|
|
415
|
-
|
|
416
|
-
## 1.1.9
|
|
417
|
-
|
|
418
|
-
- Defer model events until the surrounding transaction commits
|
|
419
|
-
|
|
420
|
-
## 1.1.8
|
|
421
|
-
|
|
422
|
-
- Exclude HTML and SPA routes from generated OpenAPI specs
|
|
423
|
-
|
|
424
|
-
## Unreleased
|
|
425
|
-
|
|
426
|
-
- `openapi:generate` (and validate/check) keep JSON API and health routes and drop HTML-only (`web` without `api`) and SPA-prefix paths instead of restamping the full hybrid table as API.
|
|
427
|
-
|
|
428
|
-
## 1.1.7
|
|
429
|
-
|
|
430
|
-
- Fix generated webhook SQL, billing hook, and hybrid SPA smoke
|
|
431
|
-
|
|
432
|
-
## 1.1.6
|
|
433
|
-
|
|
434
|
-
- Add optional OIDC cookie login and loopback discovery
|
|
435
|
-
|
|
436
|
-
## 1.1.5
|
|
437
|
-
|
|
438
|
-
- Close dogfood gaps: webhook docs, starter extras, signing helper
|
|
439
|
-
|
|
440
|
-
## Unreleased
|
|
441
|
-
|
|
442
|
-
- `make:module` appends a `registerModelClass` hint to `src/models/register.ts` when that file exists.
|
|
443
|
-
- `openapi:check` drift output reminds you to run `openapi:generate` in CI.
|
|
444
|
-
|
|
445
|
-
## 1.1.4
|
|
446
|
-
|
|
447
|
-
- Publish http/uploads, validateUploadFile, migration-adoption docs
|
|
448
|
-
|
|
449
|
-
## 1.1.3
|
|
450
|
-
|
|
451
|
-
- Eager with() arrays, OpenAPI mkdir, public-read/auth docs
|
|
452
|
-
|
|
453
|
-
## 1.1.2
|
|
454
|
-
|
|
455
|
-
- Product CLI helpers, file migrations, and job discovery.
|
|
456
|
-
|
|
457
|
-
## Unreleased
|
|
458
|
-
|
|
459
|
-
- Export `queueWorker`, `queueFailed`, `scaffold`, `openapi`, and `schedule` subpaths. Generated apps register `queue:work` through `runQueueWorkerCommand({ boot, close })` (no secrets guard in the helper), plus failed-job commands, `make:*`, `openapi:*`, and `schedule:run`. Monorepo `queue:failed` / `retry` / `flush-failed` go through `createQueueFailedCommands()` so they type as `StrataCommand`. `boot` may return a value (`bootstrapApp()` returns the app).
|
|
460
|
-
- `make:job` emits `static jobName`. `make:request` imports `@getstrata/core/http`. `make:module --with-web` writes `views/` when that directory exists.
|
|
461
|
-
- Peer dependencies on `@getstrata/core` and `@getstrata/bootstrap`.
|
|
462
|
-
|
|
463
|
-
## 1.1.1
|
|
464
|
-
|
|
465
|
-
Fix generated app boot
|
|
466
|
-
|
|
467
|
-
## 1.1.0
|
|
468
|
-
|
|
469
|
-
Lockstep with `@getstrata/core` 1.1.0. No new CLI commands. See the core 1.1.0 migration list.
|
|
470
|
-
|
|
471
|
-
## 1.0.9
|
|
472
|
-
|
|
473
|
-
Label HiroApp as internal e2e dogfood and seed notes via Model
|
|
474
|
-
|
|
475
|
-
## 1.0.8
|
|
476
|
-
|
|
477
|
-
- Container image starts and ships production dependencies only.
|
|
478
|
-
|
|
479
|
-
## 1.0.7
|
|
480
|
-
|
|
481
|
-
## 1.0.6
|
|
482
|
-
|
|
483
|
-
- Lockstep with `create-strata` 1.0.6. No runtime changes.
|
|
484
|
-
|
|
485
|
-
## 1.0.5
|
|
486
|
-
|
|
487
|
-
- Lockstep with `create-strata` 1.0.5. No runtime changes.
|
|
488
|
-
|
|
489
|
-
## 1.0.4
|
|
490
|
-
|
|
491
|
-
- Lockstep with `create-strata` 1.0.4. No runtime changes.
|
|
492
|
-
|
|
493
|
-
## 1.0.3
|
|
494
|
-
|
|
495
|
-
- Lockstep with `create-strata` 1.0.3. No runtime changes.
|
|
496
|
-
|
|
497
|
-
## 1.0.2
|
|
498
|
-
|
|
499
|
-
- Lockstep with `create-strata` 1.0.2. No runtime changes.
|
|
500
|
-
|
|
501
|
-
## 1.0.1
|
|
502
|
-
|
|
503
|
-
- `strata --help` and `strata -h` print help instead of reporting an unknown command.
|
|
504
|
-
- `migrate` and `migrate:fresh` call an optional `close()` export from the app's migrate entry. Without it, a pooled driver such as `mysql2` kept the event loop alive and the command hung after finishing its work.
|
|
505
|
-
- Dropped the `prepublishOnly` build. It produced a `dist/` that `files` never shipped; the `bin` is the Bun TypeScript entry.
|
|
506
|
-
- README no longer advertises `strata new`, which this package does not implement.
|
|
507
|
-
- `migrate` prints `Migrations applied.` and `migrate:fresh` prints `Database reset and migrated.` on success instead of exiting silently.
|
|
508
|
-
|
|
509
|
-
## 1.0.0
|
|
510
|
-
|
|
511
|
-
- First stable release of the `strata` binary: `dev`, `start`, `migrate`, `migrate:fresh`, `run`, plus app-registered commands.
|
|
10
|
+
Synchronize packages and correct installed starter template discovery. Both generator entrypoints include their selected templates in published packages.
|
package/README.md
CHANGED
|
@@ -1,94 +1,31 @@
|
|
|
1
1
|
# @getstrata/cli
|
|
2
2
|
|
|
3
|
-
The `strata`
|
|
3
|
+
The application-local `strata` command for [Strata](https://github.com/EyK-26/strata/blob/main/README.md): development servers, migrations, scaffolding, workers, OpenAPI, and scheduling. Requires Bun >=1.4.4; tested on Bun 1.4.4.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Generated applications include the CLI. To install it in an existing Strata app:
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
|
|
9
|
-
strata start
|
|
10
|
-
strata migrate
|
|
11
|
-
strata migrate:fresh
|
|
12
|
-
strata run src/scripts/backfill.ts
|
|
13
|
-
strata help
|
|
8
|
+
bun add @getstrata/cli
|
|
14
9
|
```
|
|
15
10
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
`strata run <file>` executes a file with the app preload. It is not an alias for `bun run <script>`.
|
|
19
|
-
|
|
20
|
-
`strata start` does not migrate when `APP_ENV=production`. Run `strata migrate` as an explicit deploy step.
|
|
21
|
-
|
|
22
|
-
Package-owned commands also provide `queue:work`, failed-job operations, `make:*`, `openapi:*` and `schedule:run`. Custom commands from `src/cli/register.ts` merge with the command set; user-auth starters add explicit `auth:provision-admin`.
|
|
23
|
-
|
|
24
|
-
## Running it
|
|
25
|
-
|
|
26
|
-
This package installs into your app, not globally, so `strata` lands in `node_modules/.bin` and is not on your `PATH`. Use the scripts a generated app already ships:
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
bun run dev
|
|
30
|
-
bun run db:migrate
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Or call it directly from inside the app directory:
|
|
11
|
+
Run commands from the application directory:
|
|
34
12
|
|
|
35
13
|
```bash
|
|
14
|
+
bunx strata help
|
|
36
15
|
bunx strata dev
|
|
16
|
+
bunx strata migrate
|
|
17
|
+
bunx strata make:model Task
|
|
18
|
+
bunx strata make:controller Task
|
|
19
|
+
bunx strata make:request StoreTask
|
|
20
|
+
bunx strata make:migration create_tasks
|
|
37
21
|
```
|
|
38
22
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
## How it finds your app
|
|
42
|
-
|
|
43
|
-
From the current working directory, `strata` loads `strata.config.ts` if present, then falls back to conventions:
|
|
23
|
+
Generated apps also supply scripts such as `bun run dev` and `bun run db:migrate`. The binary is installed locally; use these scripts or `bunx strata` inside the app.
|
|
44
24
|
|
|
45
|
-
|
|
46
|
-
| --- | --- |
|
|
47
|
-
| `preload` | `src/bootstrap/preload.ts` or `src/bootstrap/preloadModules.ts` |
|
|
48
|
-
| `server` | `src/bootstrap/server.ts` |
|
|
49
|
-
| `modulesDirectory` | `src/modules` |
|
|
50
|
-
| `commands` | `src/cli/register.ts` |
|
|
51
|
-
| `application` | Generated application entrypoint |
|
|
52
|
-
| `schedule` | `src/bootstrap/schedule.ts` |
|
|
53
|
-
| `migrate` | `src/db/migrate.ts` |
|
|
54
|
-
| `fresh` | `src/db/fresh.ts` |
|
|
25
|
+
Scaffolding creates model classes in `src/models`, controllers in `src/http/controllers`, and requests in `src/http/requests`. Add the model to `src/models/register.ts` and register controller actions in `src/routes/web.ts` or `src/routes/api.ts`. Migrations remain explicit. Use `bunx strata make:model --help` for table and primary-key options.
|
|
55
26
|
|
|
56
|
-
|
|
57
|
-
application entrypoint and schedule. Package-owned commands supply `queue:work`,
|
|
58
|
-
failed-job operations, `make:*`, `openapi:*` and `schedule:run`; commands that need
|
|
59
|
-
runtime services boot the selected application and close their owner afterward.
|
|
60
|
-
`src/cli/register.ts` exports `commands` or `registerCommands()` for custom commands.
|
|
61
|
-
User-auth starters also provide explicit `auth:provision-admin`; its `initialAdmin`
|
|
62
|
-
subpath reads bounded password input from a pipe and redacts provisioning errors.
|
|
63
|
-
See [initial-admin provisioning](https://github.com/EyK-26/strata/blob/main/docs/INITIAL-ADMIN.md).
|
|
64
|
-
|
|
65
|
-
Advanced command adapters remain available on `@getstrata/cli/queueWorker`,
|
|
66
|
-
`queueFailed`, `scaffold`, `openapi` and `schedule`. Scaffold paths resolve from the
|
|
67
|
-
app working directory. Prefer the package-owned commands for ordinary apps.
|
|
68
|
-
|
|
69
|
-
`make:model <Name|Group/Name>` generates an id-only declarative model under `src/models`; its repository comes from `createModel` and normal startup discovery. Use `--table=existing_table`, `--primary-key=id`, and `--key-type=number|string` for explicit metadata. UUID keys use `string`. Add domain fields to the record, table columns and allowlist before writing them. Migration generation is always separate: `make:migration <name>`. No route or custom repository is generated, and existing files/symlinked parents are refused.
|
|
70
|
-
|
|
71
|
-
Existing apps with copied command registries should adopt the package-owned commands or register `makeModelCommand` from `@getstrata/cli/scaffold` (or merge its `scaffoldCommands` map). A dependency upgrade does not rewrite those files. Use `make:model --help` for options.
|
|
72
|
-
|
|
73
|
-
`make:view reports/summary[.eta]` creates an Eta HTML template under an existing `views/`, or `resources/views/` otherwise. It supports nested names, leading-underscore partials and numeric error pages, and refuses unsafe paths, symlinks and overwrites. It does not create routes/controllers, enable views or change the app's layout/directory configuration. Register `makeViewCommand` from the same scaffold subpath in existing apps; package-owned scaffold commands include it.
|
|
74
|
-
|
|
75
|
-
Migration entry callbacks (`migrate`, `seed`, `fresh`) may accept an optional
|
|
76
|
-
frozen environment snapshot. The CLI supplies it per invocation; zero-argument
|
|
77
|
-
callbacks remain supported. Application bootstrap and CLI migrations use their
|
|
78
|
-
selected snapshot rather than mutating process defaults. `modulesDirectory` is
|
|
79
|
-
shared by module discovery, scaffolding and OpenAPI.
|
|
80
|
-
|
|
81
|
-
A migrate entry may export `close()`. The CLI calls it after `migrate()` and `fresh()` so pooled drivers such as `mysql2` release the event loop instead of hanging the command.
|
|
82
|
-
|
|
83
|
-
## Creating a new app
|
|
84
|
-
|
|
85
|
-
This package does not create whole application projects. Use the starter:
|
|
86
|
-
|
|
87
|
-
```bash
|
|
88
|
-
bunx create-strata my-app
|
|
89
|
-
```
|
|
27
|
+
`strata.config.ts` selects application, server, schedule, migration, and custom-command entry points. Custom commands come from `src/cli/register.ts`. `queue:work` and `outbox:work` run separately from HTTP. In production, apply migrations explicitly before starting the application.
|
|
90
28
|
|
|
91
|
-
|
|
29
|
+
To create a whole application, use `bunx create-strata my-app`.
|
|
92
30
|
|
|
93
|
-
- [
|
|
94
|
-
- [Building apps](https://github.com/EyK-26/strata/blob/main/docs/BUILDING-APPS.md)
|
|
31
|
+
See the [project README](https://github.com/EyK-26/strata/blob/main/README.md), [starter guide](https://github.com/EyK-26/strata/blob/main/docs/STARTER.md), [queue guide](https://github.com/EyK-26/strata/blob/main/docs/QUEUES.md), [initial-admin provisioning](https://github.com/EyK-26/strata/blob/main/docs/INITIAL-ADMIN.md), and [production guide](https://github.com/EyK-26/strata/blob/main/docs/PRODUCTION.md).
|