@w6w/sdk 0.1.0 → 0.2.0

package/README.md

@@ -10,7 +10,7 @@ The package is authored as runtime-neutral TypeScript against Web standards (`fe
 `URL`, `AbortController`), so the same build runs under Node 18+, Deno and Bun.
 
 - **License:** MIT (see [LICENSE](./LICENSE)).
-- **Version:** `0.1.0`.
+- **Version:** `0.2.0`.
 
 ## Install
 
@@ -30,13 +30,89 @@ Both registries publish the **same version at the same time** — `@w6w/sdk`, `@
 Python `w6w` package share one version number and are released together. A given version means the
 same set of operations in every language.
 
+## Quick start
+
+```ts
+import { W6wClient, isActionRun, isFunctionRun, isWorkflowRun } from "@w6w/sdk";
+
+const client = new W6wClient(); // reads W6W_BASE_URL and W6W_TOKEN
+
+// Who am I, and what versions am I talking to?
+const me = await client.me();
+
+// What can I run? `run` is addressed by a `conn_…` / `fn_…` / `ep_…` / `wf_…`
+// id — these are how you discover one.
+const connections = await client.connections.list();
+const workflows = await client.workflows.list();
+```
+
+### Run a connection action
+
+A `conn_…` id resolves to an app action. `run` returns a `kind`-tagged envelope —
+narrow it with `isActionRun` / `isFunctionRun` / `isWorkflowRun` before reading a field, since the
+three arms use different field names on purpose (`value` vs `output` vs `runId`+`status`):
+
+```ts
+const env = await client.run({
+  urn: connections[0].id, // "conn_…"
+  action: "send_message", // which of the app's actions to invoke
+  payload: { channel: "#general", text: "Hello from @w6w/sdk" },
+});
+
+if (isActionRun(env)) console.log(env.value); // the action's return value
+```
+
+### Run a function or an endpoint
+
+`fn_…` and `ep_…` ids run the same way — no `action`, since a function or endpoint has exactly one
+operation:
+
+```ts
+const env = await client.run({ urn: "fn_normalize_address", payload: { address: "1 Infinite Loop" } });
+if (isFunctionRun(env)) console.log(env.output);
+```
+
+### Run a workflow
+
+Two ways to start a `wf_…` run. `client.run()` dispatches it like anything else and always answers
+`202` (queued) — use it when you're treating workflows the same as any other runnable URN:
+
+```ts
+const env = await client.run({ urn: workflows[0].id, payload: { customerId: "cus_1" } });
+if (isWorkflowRun(env)) console.log(env.runId, env.status); // "queued"
+```
+
+`workflows.run` is the typed path, and the only one that can wait for the result server-side:
+
+```ts
+const run = await client.workflows.run(workflows[0].id, {
+  wait: true,
+  variables: { customerId: "cus_1" },
+});
+
+// A failed run is data, not a thrown error — `run.terminal` tells you it's done.
+if (run.terminal && run.status === "failed") console.error(run.error);
+else if (run.terminal) console.log(run.output);
+```
+
+### Documents and vars
+
+```ts
+const doc = await client.documents.create({ key: "welcome", content: "# Hi" });
+await client.documents.update(doc.id, { content: "# Hello" });
+await client.documents.delete(doc.id);
+
+const v = await client.vars.create({ name: "sender_email", type: "string", value: "a@b.c" });
+await client.vars.update(v.id, { value: "c@d.e" });
+```
+
 ## Configuration
 
 Two environment variables, both read only at client construction:
 
 | Variable       | Meaning                                                                                                                               | Required |
 | -------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -------- |
-| `W6W_BASE_URL` | The **origin** of your w6w server, e.g. `https://api.example.com`. The API's base path is appended by the client — do not include it. | Yes      |
+| `W6W_BASE_URL` | The **origin** of your w6w server, e.g. `https://api.example.com`. The API is served at the root of that host, so nothing is appended. | Yes      |
 | `W6W_TOKEN`    | The bearer token, sent as `Authorization: Bearer <token>` on every request.                                                           | Yes      |
 
 Explicit constructor arguments always win over the environment, and credentials are **instance
@@ -56,15 +132,21 @@ const other = new W6wClient({ baseUrl: "https://api.example.com", token: "…" }
 
 ### `W6W_BASE_URL` is an origin
 
-The client appends the API's base path (`/api`) itself, and never doubles it — so a value that
-already carries the prefix is left alone, and trailing slashes never matter:
+The API is served at the **root** of its own host — `https://api.example.com/vars`, not
+`…/api/vars` — so the client appends **nothing**. Trailing slashes never matter, and any path you
+configure is preserved verbatim, because it is indistinguishable from a real gateway prefix:
 
 | `W6W_BASE_URL`                | Requests go to                  |
 | ----------------------------- | ------------------------------- |
-| `https://api.example.com`     | `https://api.example.com/api/…` |
-| `https://api.example.com/`    | `https://api.example.com/api/…` |
-| `https://api.example.com///`  | `https://api.example.com/api/…` |
-| `https://api.example.com/api` | `https://api.example.com/api/…` |
+| `https://api.example.com`     | `https://api.example.com/…`     |
+| `https://api.example.com/`    | `https://api.example.com/…`     |
+| `https://api.example.com///`  | `https://api.example.com/…`     |
+| `https://api.example.com/gw`  | `https://api.example.com/gw/…`  |
+
+> **Breaking in `0.2.0`.** The client used to append `/api`. If your `W6W_BASE_URL` ends in `/api`
+> because of that, **drop the suffix** — the path is now preserved rather than deduplicated, so a
+> stale one 404s on every call. It is not stripped for you: a configured path is exactly how a
+> deployment behind a gateway prefix is addressed, and silently removing it would break those.
 
 A variable that is **set but empty** — or whitespace-only — counts as **unset**, in both variables.
 `W6W_BASE_URL=` is how a shell or a Dockerfile spells "I meant to set this and did not", so it

package/dist/src/config.d.ts

@@ -10,10 +10,15 @@
  */
 /**
  * The API's base path, from the shared contract's `basePath`
- * (`packages/wrappers/endpoints.json`). It is appended to the configured
- * origin by {@linkcode joinBaseUrl}; users never type it.
+ * (`packages/wrappers/endpoints.json`).
+ *
+ * **Empty since v0.2.0.** The server serves its routes at the ROOT of its own
+ * host (`https://api.w6w.io/vars`, not `.../api/vars` — the host already says
+ * "api"), so there is no prefix to append and {@linkcode joinBaseUrl} appends
+ * nothing. Kept exported, and kept mirroring the contract, so the constant
+ * still answers "what does this client prepend?" — the answer is now "nothing".
  */
-export declare const BASE_PATH = "/api";
+export declare const BASE_PATH = "";
 /**
  * A `fetch`-shaped function.
  *
@@ -29,11 +34,11 @@ export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>
 /** Constructor options for a client. Every field is optional. */
 export interface W6wClientOptions {
     /**
-     * The **origin** of the w6w server, e.g. `https://api.example.com`. The base
-     * path (`/api`) is appended for you and is never doubled. It must be an
-     * absolute `http(s)` URL with a host: a relative value like `/api` is a
-     * browser same-origin assumption with no meaning in a library, and is
-     * rejected at construction rather than misreported as an outage later.
+     * The **origin** of the w6w server, e.g. `https://api.example.com`. The API
+     * is served at its root, so no path is appended. It must be an absolute
+     * `http(s)` URL with a host: a relative value like `/api` is a browser
+     * same-origin assumption with no meaning in a library, and is rejected at
+     * construction rather than misreported as an outage later.
      * Overrides `W6W_BASE_URL`.
      */
     baseUrl?: string;
@@ -59,7 +64,7 @@ export interface W6wClientOptions {
  */
 export interface ResolvedConfig {
     /**
-     * Fully joined base, e.g. `https://api.example.com/api`. Never
+     * The normalized base, e.g. `https://api.example.com`. Never
      * trailing-slashed, and never relative — {@linkcode joinBaseUrl} rejects a
      * value that is not an absolute `http(s)` URL with a host.
      */
@@ -86,18 +91,21 @@ export interface ResolvedConfig {
  *
  * 1. strip surrounding whitespace, then **all** trailing slashes;
  * 2. reject anything that is not an absolute `http`/`https` URL with a host;
- * 3. if the result already ends with the base path, use it as-is — **never
- *    double it**;
- * 4. otherwise append the base path.
+ * 3. append nothing — the API is served at the root of its own host.
  *
  * ```
- * https://api.example.com      → https://api.example.com/api
- * https://api.example.com/     → https://api.example.com/api
- * https://api.example.com///   → https://api.example.com/api
- * https://api.example.com/api  → https://api.example.com/api
- * https://api.example.com/api/ → https://api.example.com/api
+ * https://api.example.com      → https://api.example.com
+ * https://api.example.com/     → https://api.example.com
+ * https://api.example.com///   → https://api.example.com
  * ```
  *
+ * Any path in the configured value is preserved verbatim, so a deployment that
+ * genuinely sits behind a gateway prefix can still be addressed by configuring
+ * that prefix. This is also why a stale `https://api.example.com/api` is NOT
+ * silently rewritten: it is indistinguishable from such a prefix, and quietly
+ * stripping it would break the deployments that mean it. It will 404 — the
+ * announced break for the v0.1.x base path.
+ *
  * Step 2 exists because a **relative** base URL has to fail *here*, as
  * configuration, with a message about configuration. Blank-is-absent
  * (`src/env.ts`) already stops `""` from joining to the relative `"/api"`; with

package/dist/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;GAIG;AACH,eAAO,MAAM,SAAS,SAAS,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEjF,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBlD;AAkBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,cAAc,CAS5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAS3D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEjF,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBlD;AAkBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,cAAc,CAS5E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAS3D"}

package/dist/src/config.js

@@ -12,10 +12,15 @@ import { ENV_BASE_URL, ENV_TOKEN, readEnv } from "./env.js";
 import { ConfigError } from "./errors.js";
 /**
  * The API's base path, from the shared contract's `basePath`
- * (`packages/wrappers/endpoints.json`). It is appended to the configured
- * origin by {@linkcode joinBaseUrl}; users never type it.
+ * (`packages/wrappers/endpoints.json`).
+ *
+ * **Empty since v0.2.0.** The server serves its routes at the ROOT of its own
+ * host (`https://api.w6w.io/vars`, not `.../api/vars` — the host already says
+ * "api"), so there is no prefix to append and {@linkcode joinBaseUrl} appends
+ * nothing. Kept exported, and kept mirroring the contract, so the constant
+ * still answers "what does this client prepend?" — the answer is now "nothing".
  */
-export const BASE_PATH = "/api";
+export const BASE_PATH = "";
 /**
  * An absolute `http(s)` origin, spelled with a real authority.
  *
@@ -45,18 +50,21 @@ const ABSOLUTE_HTTP_ORIGIN = /^https?:\/\/[^/\\?#]/i;
  *
  * 1. strip surrounding whitespace, then **all** trailing slashes;
  * 2. reject anything that is not an absolute `http`/`https` URL with a host;
- * 3. if the result already ends with the base path, use it as-is — **never
- *    double it**;
- * 4. otherwise append the base path.
+ * 3. append nothing — the API is served at the root of its own host.
  *
  * ```
- * https://api.example.com      → https://api.example.com/api
- * https://api.example.com/     → https://api.example.com/api
- * https://api.example.com///   → https://api.example.com/api
- * https://api.example.com/api  → https://api.example.com/api
- * https://api.example.com/api/ → https://api.example.com/api
+ * https://api.example.com      → https://api.example.com
+ * https://api.example.com/     → https://api.example.com
+ * https://api.example.com///   → https://api.example.com
  * ```
  *
+ * Any path in the configured value is preserved verbatim, so a deployment that
+ * genuinely sits behind a gateway prefix can still be addressed by configuring
+ * that prefix. This is also why a stale `https://api.example.com/api` is NOT
+ * silently rewritten: it is indistinguishable from such a prefix, and quietly
+ * stripping it would break the deployments that mean it. It will 404 — the
+ * announced break for the v0.1.x base path.
+ *
  * Step 2 exists because a **relative** base URL has to fail *here*, as
  * configuration, with a message about configuration. Blank-is-absent
  * (`src/env.ts`) already stops `""` from joining to the relative `"/api"`; with
@@ -77,17 +85,17 @@ export function joinBaseUrl(origin) {
     if (trimmed.length === 0) {
         throw new ConfigError("No w6w base URL is configured. Pass one to the client " +
             '(new W6wClient({ baseUrl: "https://api.example.com" })) or set the ' +
-            `${ENV_BASE_URL} environment variable. It holds the server's origin — the ` +
-            `${BASE_PATH} base path is appended for you.`);
+            `${ENV_BASE_URL} environment variable. It holds the server's origin, ` +
+            "e.g. \"https://api.example.com\" — the API is served at its root, so no " +
+            "path is appended.");
     }
     if (!ABSOLUTE_HTTP_ORIGIN.test(trimmed) || !parses(trimmed)) {
         throw new ConfigError(`The w6w base URL "${trimmed}" is not an absolute http(s) URL. ` +
-            `${ENV_BASE_URL} holds an ORIGIN, e.g. "https://api.example.com" — scheme and host, ` +
-            `with the ${BASE_PATH} base path appended for you. A relative or hostless value ` +
-            "cannot be requested and would fail later as a connection problem rather than as " +
-            "the configuration mistake it is.");
+            `${ENV_BASE_URL} holds an ORIGIN, e.g. "https://api.example.com" — scheme and host. ` +
+            "A relative or hostless value cannot be requested and would fail later as a " +
+            "connection problem rather than as the configuration mistake it is.");
     }
-    return trimmed.endsWith(BASE_PATH) ? trimmed : `${trimmed}${BASE_PATH}`;
+    return trimmed;
 }
 /**
  * Does the runtime's URL parser accept this origin at all?

package/dist/src/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;AA4DhC;;;;;;;;;;GAUG;AACH,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,0EAA0E;IAC1E,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,WAAW,CACnB,wDAAwD;YACtD,qEAAqE;YACrE,GAAG,YAAY,4DAA4D;YAC3E,GAAG,SAAS,iCAAiC,CAChD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,WAAW,CACnB,qBAAqB,OAAO,oCAAoC;YAC9D,GAAG,YAAY,sEAAsE;YACrF,YAAY,SAAS,4DAA4D;YACjF,kFAAkF;YAClF,kCAAkC,CACrC,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,SAAS,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,MAAM,CAAC,MAAc;IAC5B,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,UAA4B,EAAE;IAC1D,OAAO;QACL,6EAA6E;QAC7E,2EAA2E;QAC3E,+CAA+C;QAC/C,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACpE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI;QAClD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,WAAW,CACnB,yDAAyD;YACvD,6CAA6C;YAC7C,GAAG,SAAS,kEAAkE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AA4D5B;;;;;;;;;;GAUG;AACH,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,0EAA0E;IAC1E,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,WAAW,CACnB,wDAAwD;YACtD,qEAAqE;YACrE,GAAG,YAAY,uDAAuD;YACtE,0EAA0E;YAC1E,mBAAmB,CACtB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,WAAW,CACnB,qBAAqB,OAAO,oCAAoC;YAC9D,GAAG,YAAY,sEAAsE;YACrF,6EAA6E;YAC7E,oEAAoE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,MAAM,CAAC,MAAc;IAC5B,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,UAA4B,EAAE;IAC1D,OAAO;QACL,6EAA6E;QAC7E,2EAA2E;QAC3E,+CAA+C;QAC/C,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACpE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI;QAClD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,WAAW,CACnB,yDAAyD;YACvD,6CAA6C;YAC7C,GAAG,SAAS,kEAAkE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}

package/dist/src/env.d.ts

@@ -40,10 +40,12 @@ export declare const ENV_TOKEN = "W6W_TOKEN";
  * This deviates deliberately from the pinned snippet in
  * `docs/implementation.md` §2, which reads `g.Deno.env.get(name) ?? undefined`.
  * A nullish coalesce does **not** convert `""` to `undefined`, so an empty
- * `W6W_BASE_URL` would survive as a value, reach the join rule, and resolve to
- * the relative URL `"/api"` — exactly the browser same-origin default that §2
- * forbids a library from having. A relative base URL fails later, somewhere
- * else, with a message about the request rather than about the configuration.
+ * `W6W_BASE_URL` would survive as a value and short-circuit the precedence
+ * chain — the client would resolve to an empty base instead of falling through
+ * to the next source, and every request would be issued against a relative URL.
+ * That is the browser same-origin default §2 forbids a library from having, and
+ * it fails later, somewhere else, with a message about the request rather than
+ * about the configuration.
  *
  * So the check below is a **truthiness/trim** check and not a nullish one, on
  * purpose. Do not "tidy" it back to `??`. An empty-string environment variable

package/dist/src/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,gFAAgF;AAChF,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,qDAAqD;AACrD,eAAO,MAAM,SAAS,cAAc,CAAC;AAarC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQxD"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,gFAAgF;AAChF,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,qDAAqD;AACrD,eAAO,MAAM,SAAS,cAAc,CAAC;AAarC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQxD"}

package/dist/src/env.js

@@ -40,10 +40,12 @@ export const ENV_TOKEN = "W6W_TOKEN";
  * This deviates deliberately from the pinned snippet in
  * `docs/implementation.md` §2, which reads `g.Deno.env.get(name) ?? undefined`.
  * A nullish coalesce does **not** convert `""` to `undefined`, so an empty
- * `W6W_BASE_URL` would survive as a value, reach the join rule, and resolve to
- * the relative URL `"/api"` — exactly the browser same-origin default that §2
- * forbids a library from having. A relative base URL fails later, somewhere
- * else, with a message about the request rather than about the configuration.
+ * `W6W_BASE_URL` would survive as a value and short-circuit the precedence
+ * chain — the client would resolve to an empty base instead of falling through
+ * to the next source, and every request would be issued against a relative URL.
+ * That is the browser same-origin default §2 forbids a library from having, and
+ * it fails later, somewhere else, with a message about the request rather than
+ * about the configuration.
  *
  * So the check below is a **truthiness/trim** check and not a nullish one, on
  * purpose. Do not "tidy" it back to `??`. An empty-string environment variable

package/dist/src/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,qDAAqD;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AAarC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,CAAC,GAAG,UAAyC,CAAC;IACpD,IAAI,KAAyB,CAAC;IAC9B,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG;QAAE,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC9C,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG;QAAE,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;;QAChD,OAAO,SAAS,CAAC;IACtB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvE,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,qDAAqD;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AAarC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,CAAC,GAAG,UAAyC,CAAC;IACpD,IAAI,KAAyB,CAAC;IAC9B,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG;QAAE,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC9C,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG;QAAE,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;;QAChD,OAAO,SAAS,CAAC;IACtB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/version.js

@@ -10,5 +10,5 @@
  * this file as TypeScript source and rejects inferred public types ("no slow
  * types").
  */
-export const VERSION = "0.1.0";
+export const VERSION = "0.2.0";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@w6w/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Typed client for the w6w HTTP API. Thin transport, auth and error mapping — nothing else.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/w6w-io/w6w-node.git"
+    "url": "git+https://github.com/w6w-io/w6w-wrappers.git",
+    "directory": "node"
   },
-  "homepage": "https://github.com/w6w-io/w6w-node#readme",
-  "bugs": "https://github.com/w6w-io/w6w-node/issues",
+  "homepage": "https://github.com/w6w-io/w6w-wrappers/tree/main/node#readme",
+  "bugs": "https://github.com/w6w-io/w6w-wrappers/issues",
   "keywords": ["w6w", "workflow", "sdk", "client", "api"],
   "type": "module",
   "types": "./dist/mod.d.ts",