widefleet-darwin-arm64 0.3.2 → 0.4.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/README.md +26 -10
- package/package.json +3 -1
- package/release.json +1 -1
- package/starter/AGENTS.md +4 -14
- package/starter/README.md +13 -16
- package/starter/package.json +3 -2
- package/starter/pnpm-lock.yaml +33 -75
- package/starter/pnpm-workspace.yaml +1 -0
- package/starters/tanstack-start/.gitattributes +2 -0
- package/starters/tanstack-start/.gitignore +19 -0
- package/starters/tanstack-start/.oxfmtrc.json +33 -0
- package/starters/tanstack-start/.oxlintrc.json +69 -0
- package/starters/tanstack-start/AGENTS.md +24 -0
- package/starters/tanstack-start/LICENSE +21 -0
- package/starters/tanstack-start/README.md +66 -0
- package/starters/tanstack-start/package.json +47 -0
- package/starters/tanstack-start/pnpm-lock.yaml +3130 -0
- package/starters/tanstack-start/pnpm-workspace.yaml +6 -0
- package/starters/tanstack-start/src/client.tsx +20 -0
- package/starters/tanstack-start/src/env.d.ts +7 -0
- package/starters/tanstack-start/src/lib/capture-error.ts +47 -0
- package/starters/tanstack-start/src/lib/errors.ts +42 -0
- package/starters/tanstack-start/src/lib/notes.functions.ts +86 -0
- package/starters/tanstack-start/src/lib/report-error.ts +7 -0
- package/starters/tanstack-start/src/lib/server/browser-errors.ts +88 -0
- package/starters/tanstack-start/src/lib/server/capture-error.ts +35 -0
- package/starters/tanstack-start/src/lib/server/context.ts +7 -0
- package/starters/tanstack-start/src/lib/server/data.ts +48 -0
- package/starters/tanstack-start/src/lib/server/identity.ts +30 -0
- package/starters/tanstack-start/src/register.d.ts +13 -0
- package/starters/tanstack-start/src/router.tsx +12 -0
- package/starters/tanstack-start/src/routes/__root.tsx +28 -0
- package/starters/tanstack-start/src/routes/index.tsx +127 -0
- package/starters/tanstack-start/src/routes/photos.$id.ts +27 -0
- package/starters/tanstack-start/src/server.ts +67 -0
- package/starters/tanstack-start/src/start.ts +28 -0
- package/starters/tanstack-start/src/styles.css +122 -0
- package/starters/tanstack-start/tools/build.ts +26 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/LICENSE +21 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/UPSTREAM.md +7 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/effect/index.ts +21 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/effect/rules/no-manual-effect-error-tag.ts +52 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/effect/rules/no-manual-tag-comparison.ts +45 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/effect/rules/no-manual-tagged-construction.ts +37 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/effect/rules/no-service-constructor-imports.ts +52 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/effect/rules/prefer-effect-match.ts +54 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/effect/shared/tagged-values.ts +97 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/index.ts +47 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-array-filter-map.ts +28 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-chained-type-assertions.ts +77 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-conditional-empty-object-spread.ts +49 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-known-value-widening.ts +415 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-module-mocking.ts +80 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-object-parameters.ts +83 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-reduce-accumulator-copy.ts +109 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-reflect-apply.ts +28 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-reflect-get.ts +28 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-runtime-typeof.ts +77 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-shape-in-symbol-names.ts +46 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-unknown-parameters.ts +69 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-unknown-returns.ts +82 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-unknown-type-aliases.ts +54 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-unsafe-dictionary-type.ts +154 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/no-widen-then-assert.ts +366 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/require-readable-spacing.ts +47 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/rules/require-safety-comment-for-type-assertion.ts +131 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/shared/array-method.ts +94 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/shared/dictionary-types.ts +515 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/shared/function-parameters.ts +49 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/shared/lexical-type-parameters.ts +61 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/shared/reflect-method.ts +24 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/shared/scope.ts +15 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/shared/type-alias-resolution.ts +250 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/vendor/eslint-stylistic/LICENSE +22 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/vendor/eslint-stylistic/UPSTREAM.md +28 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/vendor/eslint-stylistic/padding-line-ast.ts +51 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/vendor/eslint-stylistic/padding-line-between-statements.ts +906 -0
- package/starters/tanstack-start/tools/oxlint/anti-slop/vendor/eslint-stylistic/padding-line-options.d.ts +87 -0
- package/starters/tanstack-start/tools/types.ts +31 -0
- package/starters/tanstack-start/tsconfig.json +20 -0
- package/starters/tanstack-start/vite.config.ts +49 -0
- package/starters/tanstack-start/wrangler.jsonc +17 -0
- package/widefleet +0 -0
package/README.md
CHANGED
|
@@ -7,7 +7,8 @@ access to a Widefleet installation; if you do not have one yet, start with the
|
|
|
7
7
|
## Install the CLI
|
|
8
8
|
|
|
9
9
|
The CLI supports Linux x64 with glibc, macOS on Apple Silicon and Intel,
|
|
10
|
-
and Windows x64.
|
|
10
|
+
and Windows x64. For app development, use Node.js 22.18 or newer and an existing
|
|
11
|
+
pnpm 10.34.5 or newer installation.
|
|
11
12
|
|
|
12
13
|
```sh
|
|
13
14
|
pnpm add --global widefleet
|
|
@@ -18,7 +19,7 @@ If pnpm reports that its global bin directory is missing from PATH, run `pnpm se
|
|
|
18
19
|
|
|
19
20
|
To update, rerun the install command. To uninstall, run `pnpm remove --global widefleet`. pnpm owns the complete installation directory; keep its package contents together.
|
|
20
21
|
|
|
21
|
-
The CLI includes its native executable, bundler and
|
|
22
|
+
The CLI includes its native executable, bundler and app starters. App
|
|
22
23
|
developers do not need Docker or a checkout of the platform repository when
|
|
23
24
|
connecting to an existing installation.
|
|
24
25
|
|
|
@@ -31,30 +32,44 @@ pnpm install --frozen-lockfile
|
|
|
31
32
|
pnpm dev
|
|
32
33
|
```
|
|
33
34
|
|
|
35
|
+
This creates the default SvelteKit project. For React, see the
|
|
36
|
+
[TanStack Start template and release requirements](https://widefleet.com/docs/reference/cli#create-a-project).
|
|
37
|
+
|
|
38
|
+
Both projects pin pnpm 12.4.2 in `packageManager`. With pnpm's default version
|
|
39
|
+
management, an existing pnpm 10.34.5 or newer installation automatically downloads
|
|
40
|
+
and runs that version when you run a command inside the project.
|
|
41
|
+
pnpm 10.34.5 includes the [version-switching fix](https://github.com/pnpm/pnpm/releases/tag/v10.34.5)
|
|
42
|
+
needed to start pnpm 12 on macOS and Windows.
|
|
43
|
+
|
|
34
44
|
The starter includes a notes app, a D1 database, private R2 file storage and a
|
|
35
45
|
server-side identity helper. Local development uses a synthetic user. Open the
|
|
36
46
|
local URL printed by `pnpm dev`, then stop that server with Ctrl-C before continuing.
|
|
37
47
|
|
|
38
48
|
## Connect and deploy
|
|
39
49
|
|
|
40
|
-
|
|
50
|
+
Connect to your company and deploy with CLI 0.3.2 or newer:
|
|
41
51
|
|
|
42
52
|
```sh
|
|
43
|
-
export PLATFORM_URL=https://platform.example.com
|
|
44
53
|
widefleet login
|
|
45
54
|
pnpm check
|
|
46
55
|
widefleet deploy
|
|
47
56
|
```
|
|
48
57
|
|
|
49
|
-
|
|
50
|
-
|
|
58
|
+
If IT has configured your agent or computer, the CLI uses that platform address.
|
|
59
|
+
Otherwise, it asks for your work email or company domain and looks up the company's
|
|
60
|
+
discovery record. An agent or noninteractive terminal can supply
|
|
61
|
+
`widefleet login --email employee@example.com` or
|
|
62
|
+
`widefleet login --domain example.com`. These commands also work in PowerShell and Fish.
|
|
51
63
|
|
|
52
|
-
Approve the device code in your browser. The CLI stores credentials in your
|
|
64
|
+
Approve the device code in your browser. The CLI remembers the platform URL and stores credentials in your
|
|
53
65
|
operating system's credential store: Keychain on macOS, Credential Manager on
|
|
54
66
|
Windows, and Secret Service on Linux. The store must be available and unlocked.
|
|
55
67
|
|
|
56
|
-
|
|
57
|
-
|
|
68
|
+
Run `widefleet config show` to inspect the selected URL. If discovery is not set
|
|
69
|
+
up, IT can [configure company discovery or distribute configuration](https://widefleet.com/docs/self-hosting/company-setup).
|
|
70
|
+
|
|
71
|
+
For the local demo, run `widefleet login --url http://localhost:25450` and approve
|
|
72
|
+
the code with `admin@example.test`.
|
|
58
73
|
|
|
59
74
|
The target app is identified by your installation and the `name` in
|
|
60
75
|
`wrangler.jsonc`. The first deploy creates it when needed; later deploys update
|
|
@@ -92,7 +107,7 @@ widefleet logs --level error
|
|
|
92
107
|
```
|
|
93
108
|
|
|
94
109
|
Runtime logs require telemetry services enabled by the operator; the local demo
|
|
95
|
-
includes them.
|
|
110
|
+
includes them.
|
|
96
111
|
|
|
97
112
|
## If setup fails
|
|
98
113
|
|
|
@@ -101,6 +116,7 @@ includes them. A failed log query is not evidence that the app has no errors.
|
|
|
101
116
|
| Registry returns 404 | Check the package name and published version on [npm](https://www.npmjs.com/package/widefleet). |
|
|
102
117
|
| `widefleet` is not found | Reopen the terminal after `pnpm setup`; check `Get-Command widefleet -All` in PowerShell or `type -a widefleet` in Bash/Fish for an older installation on PATH. |
|
|
103
118
|
| Login cannot access the credential store | Check your operating system's credential store; see [headless login](#headless-login) for alternatives. |
|
|
119
|
+
| Company discovery fails | Check the email domain and ask IT to publish a discovery record or configure the agent; see [company setup](https://widefleet.com/docs/self-hosting/company-setup). |
|
|
104
120
|
| Deployment fails or stays queued | Follow [deployment diagnostics](https://widefleet.com/docs/guides/deployments#inspect-a-failure). |
|
|
105
121
|
|
|
106
122
|
Next, [share the app with colleagues](https://widefleet.com/docs/guides/applications) or
|
package/package.json
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "widefleet-darwin-arm64",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Widefleet CLI with its Worker bundler and app starter",
|
|
5
|
+
"homepage": "https://widefleet.com",
|
|
5
6
|
"license": "MIT",
|
|
6
7
|
"exports": {
|
|
7
8
|
"./widefleet": "./widefleet",
|
|
@@ -18,6 +19,7 @@
|
|
|
18
19
|
"esbuild",
|
|
19
20
|
"release.json",
|
|
20
21
|
"starter",
|
|
22
|
+
"starters",
|
|
21
23
|
"licenses",
|
|
22
24
|
"README.md",
|
|
23
25
|
"LICENSE"
|
package/release.json
CHANGED
package/starter/AGENTS.md
CHANGED
|
@@ -1,22 +1,12 @@
|
|
|
1
|
-
## Philosophy
|
|
2
|
-
|
|
3
|
-
This codebase will outlive you. Every shortcut becomes someone else's burden. Every hack compounds into technical debt that slows the whole team down.
|
|
4
|
-
You are not just writing code. You are shaping the future of this project. The patterns you establish will be copied. The corners you cut will be cut again.
|
|
5
|
-
Fight entropy. Leave the codebase better than you found it.
|
|
6
|
-
Prefer correctness and predictable behavior over short-term convenience.
|
|
7
|
-
Preserve runtime behavior during lint, typing, and test-structure changes.
|
|
8
|
-
Use public package exports; never cross package boundaries with relative imports.
|
|
9
|
-
Extract shared logic only for genuinely shared behavior. Avoid generic abstractions for one-off duplication.
|
|
10
|
-
Public PRs, commits, generated files, and documentation contain no private names, internal context, customer-derived data, or AI attribution.
|
|
11
|
-
Inferred types over annotations. any is the enemy.
|
|
12
|
-
|
|
13
1
|
## Development
|
|
14
2
|
|
|
15
3
|
Read README.md for the app contract and CLI commands. Keep this project independent of the Widefleet source repository.
|
|
16
4
|
Use the installed `widefleet` CLI for app creation, deployment, history and rollback. Run `pnpm check` before deploying.
|
|
17
5
|
Use `locals.user` for the authenticated company identity. Never trust identity headers outside the platform's private ingress.
|
|
18
|
-
|
|
19
|
-
|
|
6
|
+
|
|
7
|
+
## Connect to Widefleet
|
|
8
|
+
|
|
9
|
+
Check `widefleet config show` before requesting connection details. Use company-provided or saved configuration when available. Otherwise, use a company domain or work email already available in the authorized context, or ask for the employee's work email/domain. Run `widefleet login --domain example.com` or `widefleet login --email employee@example.com`; the CLI discovers and remembers the platform URL after login. Do not ask for the platform URL as the first onboarding step. If discovery fails, report the error so IT can configure discovery or supply managed configuration. An explicit `--url` or `PLATFORM_URL` override must be removed before using email/domain discovery.
|
|
20
10
|
|
|
21
11
|
## Network access
|
|
22
12
|
|
package/starter/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# SvelteKit app on Widefleet
|
|
2
2
|
|
|
3
|
-
This is an independent app project. It needs Node.js
|
|
3
|
+
This is an independent app project. It needs Node.js 22.18 or newer, an existing pnpm 10.34.5 or newer installation and an installed Widefleet CLI release. With pnpm's default version management, the project automatically downloads and uses its pinned pnpm 12.4.2. Docker and the Widefleet source repository are not required on the developer machine.
|
|
4
4
|
|
|
5
5
|
```sh
|
|
6
6
|
pnpm install --frozen-lockfile
|
|
@@ -12,15 +12,14 @@ Local development uses a synthetic identity. Deployed apps receive the verified
|
|
|
12
12
|
|
|
13
13
|
## Deploy
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
Connect to your company, then authenticate. The CLI uses company-provided or saved configuration. Otherwise, it asks for your work email or company domain. Approve the device code in your browser; subsequent commands use the saved URL and session.
|
|
16
16
|
|
|
17
17
|
```sh
|
|
18
|
-
export PLATFORM_URL=https://platform.example.com
|
|
19
18
|
widefleet login
|
|
20
19
|
widefleet deploy
|
|
21
20
|
```
|
|
22
21
|
|
|
23
|
-
|
|
22
|
+
For an agent or noninteractive terminal, use `widefleet login --email employee@example.com` or `widefleet login --domain example.com`. IT must publish the company's TXT record or HTTPS discovery file, or preconfigure the agent's environment. Run `widefleet config show` to inspect the selected URL. An explicit URL supplied by IT remains supported through `widefleet login --url https://platform.example.com`.
|
|
24
23
|
|
|
25
24
|
The deployment target is the combination of the selected platform and `name` in `wrangler.jsonc`, following Wrangler's account-and-Worker-name model. `widefleet init` derives this name from the project directory. Review it before the first deployment. The first deploy creates the app; later deploys with the same name update it if you have permission. A fresh checkout works with the same configuration and login, without a local app-ID file or linking command. Changing `name` selects another app, and a deleted app is created again if deployed under that name.
|
|
26
25
|
|
|
@@ -28,21 +27,21 @@ The platform assigns the shared fleet. Each app keeps its own identity and resou
|
|
|
28
27
|
|
|
29
28
|
This flow requires CLI and management server 0.1.5 or newer. Explicit `widefleet deploy APP_UUID` remains available for existing scripts and overrides the configured name for that invocation. Use `widefleet apps` to inspect app IDs for history, rollback and administration.
|
|
30
29
|
|
|
31
|
-
|
|
30
|
+
Login uses an unlocked OS credential store by default. In a headless Unix shell, a CLI build with `--session-file` support can instead store the session in an explicitly selected, unencrypted file:
|
|
32
31
|
|
|
33
32
|
```sh
|
|
34
33
|
export PLATFORM_SESSION_FILE="$HOME/.local/state/widefleet/session.json"
|
|
35
34
|
widefleet login
|
|
36
35
|
```
|
|
37
36
|
|
|
38
|
-
Keep this variable set for subsequent commands, including `widefleet logout`. The CLI creates a private directory (`0700`) and file (`0600`), renews tokens automatically and binds the file to the selected platform.
|
|
37
|
+
Keep this variable set for subsequent commands, including `widefleet logout`. The CLI creates a private directory (`0700`) and file (`0600`), renews tokens automatically and binds the file to the selected platform. Keep the file outside this project and shared artifacts. For externally managed credentials, an operator may supply a short-lived API access token as `PLATFORM_ACCESS_TOKEN`; it takes precedence over the saved session and is not renewed automatically. Never commit credentials. See [CLI authentication](https://widefleet.com/docs/reference/authentication) for session storage and renewal details.
|
|
39
38
|
|
|
40
39
|
## App contract
|
|
41
40
|
|
|
42
41
|
- Edit `src/routes` to build your app. Read `locals.user` in server handlers; the server hook validates the platform identity headers.
|
|
43
42
|
- Declare D1, R2, KV, queue producers/consumers, cron schedules, static assets and plain text variables in `wrangler.jsonc`. Resource names remain stable across deployments. The initial names are isolated per app.
|
|
44
|
-
-
|
|
45
|
-
-
|
|
43
|
+
- Build a single bundled Worker module. The starter enables `nodejs_compat`; existing `nodejs_als` projects remain supported. The CLI validates configuration before uploading.
|
|
44
|
+
- Use `locals.user` for the platform's authenticated identity. The platform handles login, strips cookies from app requests and removes `Set-Cookie` from app responses.
|
|
46
45
|
- Database and file contents survive code deployments and rollback. Apply schema migrations explicitly with `widefleet migrations`; deployments do not run them.
|
|
47
46
|
- TypeScript uses strictest; `pnpm check` runs type checking, Oxfmt and type-aware Oxlint with anti-slop. Generated Worker JavaScript is excluded from TypeScript checking.
|
|
48
47
|
|
|
@@ -63,9 +62,9 @@ widefleet migrations apply DB
|
|
|
63
62
|
|
|
64
63
|
Resources are created only when declared in `wrangler.jsonc`. Equal resource names in different apps/previews stay isolated. `d1_databases`, `r2_buckets`, `kv_namespaces`, `queues.producers`, `queues.consumers` and `triggers.crons` use Wrangler-style configuration. Keep identifiers stable to keep using the same data. Removing a binding does not migrate or erase its native data.
|
|
65
64
|
|
|
66
|
-
Use the normal D1, R2, KV and Queue producer APIs from `env`. The dynamic runtime's adapters preserve D1 prepared statements/batches/sessions, R2 metadata/ranges/multipart operations, and KV text/JSON/bytes/metadata/listing.
|
|
65
|
+
Use the normal D1, R2, KV and Queue producer APIs from `env`. The dynamic runtime's adapters preserve D1 prepared statements/batches/sessions, R2 metadata/ranges/multipart operations, and KV text/JSON/bytes/metadata/listing. See [runtime compatibility](https://widefleet.com/docs/reference/runtime-compatibility) for supported methods and streaming behavior.
|
|
67
66
|
|
|
68
|
-
A custom Worker entry module may export `scheduled(controller, env, ctx)` and `queue(batch, env, ctx)` alongside `fetch
|
|
67
|
+
A custom Worker entry module may export `scheduled(controller, env, ctx)` and `queue(batch, env, ctx)` alongside the generated SvelteKit `fetch` handler. The platform forwards `waitUntil`, `noRetry`, message acknowledgments and retry decisions.
|
|
69
68
|
|
|
70
69
|
App Workflows require CLI and platform 0.3.0 or newer, a matching deployment agent and app runtime 0.2.0 or newer advertising Workflow support. Declare `workflows` entries with `binding`, `name` and `class_name`, and export the corresponding `WorkflowEntrypoint` classes from the main module alongside the generated HTTP handler. Use `widefleet workflows --help` for management commands. User-defined Durable Object namespaces remain outside the dynamic app contract.
|
|
71
70
|
|
|
@@ -83,17 +82,15 @@ widefleet network allow https://assets.example.com --browser
|
|
|
83
82
|
widefleet network deny https://api.example.com
|
|
84
83
|
```
|
|
85
84
|
|
|
86
|
-
Commands use this project's configured name; `--app NAME` selects another existing app.
|
|
85
|
+
Commands use this project's configured name; `--app NAME` selects another existing app. Changes wait for activation unless `--no-wait` is supplied. Backend and browser lists start empty. Same-origin browser requests and resource bindings remain usable. Manage network permissions through the platform CLI or UI. Grants persist across code rollbacks, and previews have their own permissions.
|
|
87
86
|
|
|
88
|
-
A browser grant allows connections and resource loading, including scripts/styles, from that origin. CSP
|
|
87
|
+
A browser grant allows connections and resource loading, including scripts/styles, from that origin. The platform enforces CSP on app responses: same-origin/inline scripts and styles are allowed; frames, objects and Web Workers are blocked. Top-level navigation to external pages remains possible. Reload open tabs to receive policy changes. Backend redirects are checked at every hop. Body-preserving redirects can replay fully sent uploads up to 1 MiB; original uploads are streamed without that limit.
|
|
89
88
|
|
|
90
89
|
## Node.js compatibility
|
|
91
90
|
|
|
92
91
|
With `"compatibility_flags": ["nodejs_compat"]`, Widefleet leaves Node builtins such as `node:buffer`, `node:crypto` and bare imports such as `path` for celld to resolve. npm dependencies are bundled locally, Worker package export conditions are enabled, and bundled CommonJS dependencies can require runtime builtins. Existing apps can opt in by changing this flag and redeploying with CLI 0.1.3 or newer against an updated management server.
|
|
93
92
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
celld already exposes its implemented Node APIs and does not use `nodejs_compat` as a runtime switch. In Widefleet the explicit flag selects the matching bundler behavior; the compatibility date alone does not enable it. The agent continues to deploy prebundled code without running a build or package scripts.
|
|
93
|
+
See [Node.js compatibility](https://widefleet.com/docs/reference/runtime-compatibility#nodejs-compatibility) for the supported API surface and runtime differences. The agent deploys the code bundled locally.
|
|
97
94
|
|
|
98
95
|
The platform validates app snapshots before activation. Rejected updates retain the serving version; interrupted installations are recovered by the executor before subsequent work.
|
|
99
96
|
|
|
@@ -140,4 +137,4 @@ App telemetry currently covers HTTP console records and exceptions. RPC, Cron an
|
|
|
140
137
|
|
|
141
138
|
## IT connector bindings
|
|
142
139
|
|
|
143
|
-
After IT grants a connector, call its native RPC methods directly, for example `env.ERP.listCustomers()`. IT supplies the connector's TypeScript interface. Use the normal CLI login and `widefleet connector bind erp --as ERP` from this app project (administrator permission required); `widefleet connector bindings` shows the current mapping and activation state. An explicit `--app NAME` selects another app.
|
|
140
|
+
After IT grants a connector, call its native RPC methods directly, for example `env.ERP.listCustomers()`. IT supplies the connector's TypeScript interface. Use the normal CLI login and `widefleet connector bind erp --as ERP` from this app project (administrator permission required); `widefleet connector bindings` shows the current mapping and activation state. An explicit `--app NAME` selects another app. Configure grants separately for previews; code rollback retains the current grants. Connector code and its optional Durable Objects are deployed separately with `widefleet connector deploy`.
|
package/starter/package.json
CHANGED
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"@sveltejs/kit": "3.0.0",
|
|
25
25
|
"@sveltejs/vite-plugin-svelte": "7.3.1",
|
|
26
26
|
"@tsconfig/strictest": "2.0.8",
|
|
27
|
-
"@types/node": "
|
|
27
|
+
"@types/node": "22.18.0",
|
|
28
28
|
"oxfmt": "0.71.0",
|
|
29
29
|
"oxlint": "1.86.0",
|
|
30
30
|
"oxlint-tsgolint": "7.0.2003",
|
|
@@ -35,7 +35,8 @@
|
|
|
35
35
|
"wrangler": "4.147.0"
|
|
36
36
|
},
|
|
37
37
|
"engines": {
|
|
38
|
-
"node": ">=
|
|
38
|
+
"node": ">=22.18.0",
|
|
39
|
+
"pnpm": ">=10.34.5"
|
|
39
40
|
},
|
|
40
41
|
"packageManager": "pnpm@12.4.2"
|
|
41
42
|
}
|