@vxil/sdk 0.4.0 → 0.4.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.
- package/README.md +4 -0
- package/dist/index.d.ts +7 -7
- package/dist/index.js +4 -4
- package/package.json +2 -3
package/README.md
CHANGED
|
@@ -88,6 +88,10 @@ try {
|
|
|
88
88
|
|
|
89
89
|
## Changelog
|
|
90
90
|
|
|
91
|
+
### 0.4.1 — 2026-09-13
|
|
92
|
+
|
|
93
|
+
- Documentation only: JSDoc no longer cites internal repository paths; points at the public guide instead. No runtime change.
|
|
94
|
+
|
|
91
95
|
### 0.4.0 — 2026-09-11
|
|
92
96
|
|
|
93
97
|
- React-Native-clean: every query string is built without `URLSearchParams` (React Native's polyfill throws on `.set` before 0.81); wire bytes unchanged.
|
package/dist/index.d.ts
CHANGED
|
@@ -84,11 +84,11 @@ export interface VxilOptions {
|
|
|
84
84
|
* a mobile/SPA holds a public/thin-client key + the signed-in user's session
|
|
85
85
|
* token and calls the edge directly, safely scoped to that user. Absent ⇒
|
|
86
86
|
* **no header** ⇒ server-caller mode, exactly as today (backward compatible).
|
|
87
|
-
* See docs/
|
|
87
|
+
* See https://vxil.com/docs/guide/09-security-and-multitenancy. For a per-call override on
|
|
88
88
|
* an otherwise server-mode client, use `vx.asEndUser(token)`. */
|
|
89
89
|
endUserToken?: string;
|
|
90
90
|
/** Global API major every request pins (default `'v1'`). Path-major, per
|
|
91
|
-
* docs/
|
|
91
|
+
* the versioning section of https://vxil.com/docs/guide/12-going-to-production — a breaking change ships as a new major on a
|
|
92
92
|
* new path, never in place. */
|
|
93
93
|
apiVersion?: ApiVersion;
|
|
94
94
|
/** Per-feature API-major overrides (`{ cms: 'v2' }`); each takes precedence
|
|
@@ -1345,7 +1345,7 @@ export declare class Vxil<S extends VxilSchemaShape = VxilSchemaShape> {
|
|
|
1345
1345
|
* client, mirroring how the edge threads the verified principal. The base
|
|
1346
1346
|
* URL, api key, fetch impl, version pins and the retry/timeout/hooks options
|
|
1347
1347
|
* are inherited unchanged; only the end-user token is (re)set. Pass a falsy token to get back a server-mode
|
|
1348
|
-
* client (drops the header). See docs/
|
|
1348
|
+
* client (drops the header). See https://vxil.com/docs/guide/09-security-and-multitenancy. */
|
|
1349
1349
|
asEndUser(endUserToken: string | undefined): Vxil<S>;
|
|
1350
1350
|
/** Build the versioned request path — the ONE place a wire path is finalized.
|
|
1351
1351
|
* Every request (call(), audit.export, the fn proxy) routes through here, so
|
|
@@ -1620,7 +1620,7 @@ export declare class Vxil<S extends VxilSchemaShape = VxilSchemaShape> {
|
|
|
1620
1620
|
* ADVISORY vxil plan — which features to enable, a materialized `config_draft`,
|
|
1621
1621
|
* and which truly-unique logic needs a tenant function. Deterministic + pure;
|
|
1622
1622
|
* it PROPOSES a plan, it never applies anything (review it, then push the
|
|
1623
|
-
* config). Needs `features:read`. (POST /v1/plan; docs/
|
|
1623
|
+
* config). Needs `features:read`. (POST /v1/plan; https://vxil.com/docs/guide/10-agents-and-mcp) */
|
|
1624
1624
|
readonly planner: {
|
|
1625
1625
|
create: (description: string, name?: string) => Promise<VxilPlan>;
|
|
1626
1626
|
};
|
|
@@ -1832,7 +1832,7 @@ export declare class Vxil<S extends VxilSchemaShape = VxilSchemaShape> {
|
|
|
1832
1832
|
delete: (ruleId: string) => Promise<void>;
|
|
1833
1833
|
};
|
|
1834
1834
|
};
|
|
1835
|
-
/** vxil-auth. SCOPES (docs/
|
|
1835
|
+
/** vxil-auth. SCOPES (vxil.com/docs/guide/09-security-and-multitenancy): every flow here that
|
|
1836
1836
|
* obtains, renews, verifies or ends the caller's OWN session (signUp/signIn,
|
|
1837
1837
|
* magicLink, otp, anonymous, stepUp, oauth, sessions.refresh/revoke/verify,
|
|
1838
1838
|
* password reset) accepts the narrow `auth:signin` — the ONLY auth scope a
|
|
@@ -2174,7 +2174,7 @@ export declare class Vxil<S extends VxilSchemaShape = VxilSchemaShape> {
|
|
|
2174
2174
|
create: (input: {
|
|
2175
2175
|
collection: string;
|
|
2176
2176
|
singular?: string;
|
|
2177
|
-
/** End-user owner-scoping (docs/
|
|
2177
|
+
/** End-user owner-scoping (https://vxil.com/docs/guide/09-security-and-multitenancy):
|
|
2178
2178
|
* names an existing `string` field that holds the owner id. When set,
|
|
2179
2179
|
* the cms worker auto-scopes owned reads/writes to the VERIFIED
|
|
2180
2180
|
* end-user principal (default-deny) in end-user mode; a no-op in
|
|
@@ -2474,7 +2474,7 @@ export declare class Vxil<S extends VxilSchemaShape = VxilSchemaShape> {
|
|
|
2474
2474
|
* only the envelope: membership, read-cursors, mute, and a directed block
|
|
2475
2475
|
* list; the messages themselves are `comments` rows on the
|
|
2476
2476
|
* `dm:<conversation_id>` topic. Gated by its own `dm` config, independent of
|
|
2477
|
-
* comments. See docs/
|
|
2477
|
+
* comments. See vxil.com/docs/guide/06-feature-catalog.
|
|
2478
2478
|
*/
|
|
2479
2479
|
readonly dm: {
|
|
2480
2480
|
/** Read the resolved DM config (defaults merged with the stored partial). */
|
package/dist/index.js
CHANGED
|
@@ -150,7 +150,7 @@ export class Vxil {
|
|
|
150
150
|
* client, mirroring how the edge threads the verified principal. The base
|
|
151
151
|
* URL, api key, fetch impl, version pins and the retry/timeout/hooks options
|
|
152
152
|
* are inherited unchanged; only the end-user token is (re)set. Pass a falsy token to get back a server-mode
|
|
153
|
-
* client (drops the header). See docs/
|
|
153
|
+
* client (drops the header). See https://vxil.com/docs/guide/09-security-and-multitenancy. */
|
|
154
154
|
asEndUser(endUserToken) {
|
|
155
155
|
return new Vxil({
|
|
156
156
|
apiKey: this.key,
|
|
@@ -402,7 +402,7 @@ export class Vxil {
|
|
|
402
402
|
* ADVISORY vxil plan — which features to enable, a materialized `config_draft`,
|
|
403
403
|
* and which truly-unique logic needs a tenant function. Deterministic + pure;
|
|
404
404
|
* it PROPOSES a plan, it never applies anything (review it, then push the
|
|
405
|
-
* config). Needs `features:read`. (POST /v1/plan; docs/
|
|
405
|
+
* config). Needs `features:read`. (POST /v1/plan; https://vxil.com/docs/guide/10-agents-and-mcp) */
|
|
406
406
|
planner = {
|
|
407
407
|
create: async (description, name) => (await this.call('POST', '/v1/plan', {
|
|
408
408
|
description,
|
|
@@ -544,7 +544,7 @@ export class Vxil {
|
|
|
544
544
|
},
|
|
545
545
|
},
|
|
546
546
|
};
|
|
547
|
-
/** vxil-auth. SCOPES (docs/
|
|
547
|
+
/** vxil-auth. SCOPES (vxil.com/docs/guide/09-security-and-multitenancy): every flow here that
|
|
548
548
|
* obtains, renews, verifies or ends the caller's OWN session (signUp/signIn,
|
|
549
549
|
* magicLink, otp, anonymous, stepUp, oauth, sessions.refresh/revoke/verify,
|
|
550
550
|
* password reset) accepts the narrow `auth:signin` — the ONLY auth scope a
|
|
@@ -880,7 +880,7 @@ export class Vxil {
|
|
|
880
880
|
* only the envelope: membership, read-cursors, mute, and a directed block
|
|
881
881
|
* list; the messages themselves are `comments` rows on the
|
|
882
882
|
* `dm:<conversation_id>` topic. Gated by its own `dm` config, independent of
|
|
883
|
-
* comments. See docs/
|
|
883
|
+
* comments. See vxil.com/docs/guide/06-feature-catalog.
|
|
884
884
|
*/
|
|
885
885
|
dm = {
|
|
886
886
|
/** Read the resolved DM config (defaults merged with the stored partial). */
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vxil/sdk",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.1",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "Typed client for the Vxil REST API (notifications, auth, jobs, files, cms, comments, webhooks, realtime, orgs, rate-limits).",
|
|
@@ -10,8 +10,7 @@
|
|
|
10
10
|
"backend",
|
|
11
11
|
"baas",
|
|
12
12
|
"sdk",
|
|
13
|
-
"typed-client"
|
|
14
|
-
"cloudflare-workers"
|
|
13
|
+
"typed-client"
|
|
15
14
|
],
|
|
16
15
|
"engines": {
|
|
17
16
|
"node": ">=18"
|