@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 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/end-user-principals-design.md §4.1, §10. For a per-call override on
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/feature-versioning.md — a breaking change ships as a new major on a
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/end-user-principals-design.md §4.1. */
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/planner-feature-design.md) */
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/features/auth.md §7.6): every flow here that
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/end-user-principals-design.md §5.1):
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/features/dm.md.
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/end-user-principals-design.md §4.1. */
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/planner-feature-design.md) */
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/features/auth.md §7.6): every flow here that
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/features/dm.md.
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.0",
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"