@productcraft/core 0.2.0 → 0.3.0

package/README.md

@@ -12,7 +12,8 @@ You **don't install this directly**. It's a runtime dependency of every product
   | { type: "bearer"; token: string }  // pre-resolved JWT
   | { type: "cookie"; value: string }  // captured auth_token
   ```
-- `PCClientConfig` — `{ auth?, baseUrl?, fetch? }`, the input shape every surface constructor takes.
+- `PCClientConfig` — `{ auth?, baseUrl?, fetch? }`, the input shape every surface constructor takes. When `auth` is omitted, `resolveAuth` falls back to `PRODUCTCRAFT_API_KEY` from the environment (server-side only; never read without a `process` global).
+- `PC_API_KEY_ENV` / `PC_AUTH_APP_ENV` / `readEnv` / `resolveAuth` — the env-fallback helpers. Hosts are never read from the environment.
 - `PC_BASE_URL` — the per-surface prod base URLs, used as defaults.
 - `makeClient<paths>(baseUrl, config)` — internal helper that wires an `openapi-fetch` client with the auth-header middleware.
 

package/dist/index.cjs

@@ -18,6 +18,21 @@ var PC_BASE_URL = {
   social: "https://social.productcraft.co",
   trawl: "https://api.trawl.productcraft.co"
 };
+var PC_API_KEY_ENV = "PRODUCTCRAFT_API_KEY";
+var PC_AUTH_APP_ENV = "PRODUCTCRAFT_AUTH_APP";
+function readEnv(name) {
+  const proc = globalThis.process;
+  if (typeof proc === "undefined" || !proc || !proc.env) return void 0;
+  const value = proc.env[name];
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function resolveAuth(auth) {
+  if (auth) return auth;
+  const key = readEnv(PC_API_KEY_ENV);
+  return key ? { type: "apiKey", key } : void 0;
+}
 function authMiddleware(auth) {
   return {
     async onRequest({ request }) {
@@ -42,12 +57,16 @@ function makeClient(defaultBaseUrl, config = {}) {
     baseUrl: config.baseUrl ?? defaultBaseUrl,
     fetch: config.fetch
   });
-  client.use(authMiddleware(config.auth));
+  client.use(authMiddleware(resolveAuth(config.auth)));
   return client;
 }
 
+exports.PC_API_KEY_ENV = PC_API_KEY_ENV;
+exports.PC_AUTH_APP_ENV = PC_AUTH_APP_ENV;
 exports.PC_BASE_URL = PC_BASE_URL;
 exports.authMiddleware = authMiddleware;
 exports.makeClient = makeClient;
+exports.readEnv = readEnv;
+exports.resolveAuth = resolveAuth;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["createClient"],"mappings":";;;;;;;;;AAgDO,IAAM,WAAA,GAAc;AAAA;AAAA;AAAA;AAAA,EAIzB,YAAA,EAAc,2CAAA;AAAA,EACd,IAAA,EAAM,kCAAA;AAAA,EACN,IAAA,EAAM,kCAAA;AAAA,EACN,QAAA,EAAU,sCAAA;AAAA,EACV,MAAA,EAAQ,gCAAA;AAAA,EACR,KAAA,EAAO;AACT;AAMO,SAAS,eAAe,IAAA,EAAsC;AACnE,EAAA,OAAO;AAAA,IACL,MAAM,SAAA,CAAU,EAAE,OAAA,EAAQ,EAAG;AAC3B,MAAA,IAAI,CAAC,MAAM,OAAO,MAAA;AAClB,MAAA,QAAQ,KAAK,IAAA;AAAM,QACjB,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AACzD,UAAA;AAAA,QACF,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AAC3D,UAAA;AAAA,QACF,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,QAAA,EAAU,CAAA,WAAA,EAAc,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AACxD,UAAA;AAAA;AAEJ,MAAA,OAAO,OAAA;AAAA,IACT;AAAA,GACF;AACF;AAQO,SAAS,UAAA,CACd,cAAA,EACA,MAAA,GAAyB,EAAC,EACV;AAChB,EAAA,MAAM,SAASA,6BAAA,CAAqB;AAAA,IAClC,OAAA,EAAS,OAAO,OAAA,IAAW,cAAA;AAAA,IAC3B,OAAO,MAAA,CAAO;AAAA,GACf,CAAA;AACD,EAAA,MAAA,CAAO,GAAA,CAAI,cAAA,CAAe,MAAA,CAAO,IAAI,CAAC,CAAA;AACtC,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["/**\n * Shared transport + auth plumbing used by every surface client.\n *\n * Each surface package (`@productcraft/auth`, `@productcraft/mail`,\n * ...) defines a thin class around `openapi-fetch` plus the generated\n * `paths` types from its own `_generated.d.ts`. The class delegates\n * wire I/O to `openapi-fetch`, but exposes a Stripe-style ergonomic\n * surface where callers reach for `pc.mail.messages.send(...)` rather\n * than the underlying `client.POST(\"/v1/...\")` shape.\n *\n * v0 ships only the underlying `client` (named `client` on each\n * surface) — every endpoint is reachable through it. Ergonomic\n * resource surfaces land in v0.1+ as we hand-roll them.\n */\n\nimport createClient, { type Client, type Middleware } from \"openapi-fetch\";\n\n/**\n * The auth credential the SDK presents to ProductCraft APIs.\n *\n * - `apiKey` — Platform API Key (`pcft_live_*`). Server-side only;\n *   never embed in a shipped browser bundle.\n * - `bearer` — pre-resolved JWT (e.g. an Auth app-scoped EndUser\n *   token your backend minted and shipped to the device).\n * - `cookie` — captured `auth_token` cookie value. Mostly useful in\n *   dev / E2E tests where you've already signed in.\n */\nexport type PCAuth =\n  | { type: \"apiKey\"; key: string }\n  | { type: \"bearer\"; token: string }\n  | { type: \"cookie\"; value: string };\n\nexport interface PCClientConfig {\n  auth?: PCAuth;\n  /** Override the prod base URL — useful for dev / staging. */\n  baseUrl?: string;\n  /** Custom fetch (e.g. node-fetch with retries, undici, ...). */\n  fetch?: typeof fetch;\n}\n\n/**\n * Default prod base URL per surface.\n *\n * Keys use the rebranded product names (Auth, Mail, Waitlist, Social)\n * matching the package + class names since the 2026-07 SDK rename.\n * Prior releases (`@productcraft/heimdall` 0.x etc.) exposed the same\n * hosts under the old keys (heimdall/envoi/rally/agora).\n */\nexport const PC_BASE_URL = {\n  // platformAuth is the platform identity layer (workspaces, PATs);\n  // it vacated api.auth so the customer-facing Auth product could\n  // take that host.\n  platformAuth: \"https://api.platform-auth.productcraft.co\",\n  auth: \"https://api.auth.productcraft.co\",\n  mail: \"https://api.mail.productcraft.co\",\n  waitlist: \"https://api.waitlist.productcraft.co\",\n  social: \"https://social.productcraft.co\",\n  trawl: \"https://api.trawl.productcraft.co\",\n} as const;\n\n/**\n * Build an `openapi-fetch` middleware that adds the configured auth\n * credential as a header on every outbound request.\n */\nexport function authMiddleware(auth: PCAuth | undefined): Middleware {\n  return {\n    async onRequest({ request }) {\n      if (!auth) return undefined;\n      switch (auth.type) {\n        case \"apiKey\":\n          request.headers.set(\"Authorization\", `Bearer ${auth.key}`);\n          break;\n        case \"bearer\":\n          request.headers.set(\"Authorization\", `Bearer ${auth.token}`);\n          break;\n        case \"cookie\":\n          request.headers.set(\"Cookie\", `auth_token=${auth.value}`);\n          break;\n      }\n      return request;\n    },\n  };\n}\n\n/**\n * Construct an `openapi-fetch` client for a surface. Each surface\n * package calls this with its own generated `paths` type and default\n * base URL. The returned client is the v0 surface — every endpoint is\n * reachable through `client.GET(...)`, `client.POST(...)`, etc.\n */\nexport function makeClient<TPaths extends object>(\n  defaultBaseUrl: string,\n  config: PCClientConfig = {},\n): Client<TPaths> {\n  const client = createClient<TPaths>({\n    baseUrl: config.baseUrl ?? defaultBaseUrl,\n    fetch: config.fetch,\n  });\n  client.use(authMiddleware(config.auth));\n  return client;\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["createClient"],"mappings":";;;;;;;;;AAqDO,IAAM,WAAA,GAAc;AAAA;AAAA;AAAA;AAAA,EAIzB,YAAA,EAAc,2CAAA;AAAA,EACd,IAAA,EAAM,kCAAA;AAAA,EACN,IAAA,EAAM,kCAAA;AAAA,EACN,QAAA,EAAU,sCAAA;AAAA,EACV,MAAA,EAAQ,gCAAA;AAAA,EACR,KAAA,EAAO;AACT;AAGO,IAAM,cAAA,GAAiB;AAEvB,IAAM,eAAA,GAAkB;AAQxB,SAAS,QAAQ,IAAA,EAAkC;AACxD,EAAA,MAAM,OAAQ,UAAA,CACX,OAAA;AACH,EAAA,IAAI,OAAO,SAAS,WAAA,IAAe,CAAC,QAAQ,CAAC,IAAA,CAAK,KAAK,OAAO,MAAA;AAC9D,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA;AAC3B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,MAAA;AACtC,EAAA,MAAM,OAAA,GAAU,MAAM,IAAA,EAAK;AAC3B,EAAA,OAAO,OAAA,KAAY,KAAK,MAAA,GAAY,OAAA;AACtC;AAQO,SAAS,YAAY,IAAA,EAA8C;AACxE,EAAA,IAAI,MAAM,OAAO,IAAA;AACjB,EAAA,MAAM,GAAA,GAAM,QAAQ,cAAc,CAAA;AAClC,EAAA,OAAO,GAAA,GAAM,EAAE,IAAA,EAAM,QAAA,EAAU,KAAI,GAAI,MAAA;AACzC;AAMO,SAAS,eAAe,IAAA,EAAsC;AACnE,EAAA,OAAO;AAAA,IACL,MAAM,SAAA,CAAU,EAAE,OAAA,EAAQ,EAAG;AAC3B,MAAA,IAAI,CAAC,MAAM,OAAO,MAAA;AAClB,MAAA,QAAQ,KAAK,IAAA;AAAM,QACjB,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AACzD,UAAA;AAAA,QACF,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AAC3D,UAAA;AAAA,QACF,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,QAAA,EAAU,CAAA,WAAA,EAAc,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AACxD,UAAA;AAAA;AAEJ,MAAA,OAAO,OAAA;AAAA,IACT;AAAA,GACF;AACF;AAWO,SAAS,UAAA,CACd,cAAA,EACA,MAAA,GAAyB,EAAC,EACV;AAChB,EAAA,MAAM,SAASA,6BAAA,CAAqB;AAAA,IAClC,OAAA,EAAS,OAAO,OAAA,IAAW,cAAA;AAAA,IAC3B,OAAO,MAAA,CAAO;AAAA,GACf,CAAA;AACD,EAAA,MAAA,CAAO,IAAI,cAAA,CAAe,WAAA,CAAY,MAAA,CAAO,IAAI,CAAC,CAAC,CAAA;AACnD,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["/**\n * Shared transport + auth plumbing used by every surface client.\n *\n * Each surface package (`@productcraft/auth`, `@productcraft/mail`,\n * ...) defines a thin class around `openapi-fetch` plus the generated\n * `paths` types from its own `_generated.d.ts`. The class delegates\n * wire I/O to `openapi-fetch`, but exposes a Stripe-style ergonomic\n * surface where callers reach for `pc.mail.messages.send(...)` rather\n * than the underlying `client.POST(\"/v1/...\")` shape.\n *\n * v0 ships only the underlying `client` (named `client` on each\n * surface) — every endpoint is reachable through it. Ergonomic\n * resource surfaces land in v0.1+ as we hand-roll them.\n */\n\nimport createClient, { type Client, type Middleware } from \"openapi-fetch\";\n\n/**\n * The auth credential the SDK presents to ProductCraft APIs.\n *\n * - `apiKey` — Platform API Key (`pcft_live_*`). Server-side only;\n *   never embed in a shipped browser bundle.\n * - `bearer` — pre-resolved JWT (e.g. an Auth app-scoped EndUser\n *   token your backend minted and shipped to the device).\n * - `cookie` — captured `auth_token` cookie value. Mostly useful in\n *   dev / E2E tests where you've already signed in.\n */\nexport type PCAuth =\n  | { type: \"apiKey\"; key: string }\n  | { type: \"bearer\"; token: string }\n  | { type: \"cookie\"; value: string };\n\nexport interface PCClientConfig {\n  /**\n   * Credential for every request. Server-side, omit it to fall back to\n   * the `PRODUCTCRAFT_API_KEY` environment variable (your `pcft_`\n   * workspace key). An explicit value always wins over the environment.\n   */\n  auth?: PCAuth;\n  /** Override the prod base URL — useful for dev / staging. */\n  baseUrl?: string;\n  /** Custom fetch (e.g. node-fetch with retries, undici, ...). */\n  fetch?: typeof fetch;\n}\n\n/**\n * Default prod base URL per surface.\n *\n * Keys use the rebranded product names (Auth, Mail, Waitlist, Social)\n * matching the package + class names since the 2026-07 SDK rename.\n * Prior releases (`@productcraft/heimdall` 0.x etc.) exposed the same\n * hosts under the old keys (heimdall/envoi/rally/agora).\n */\nexport const PC_BASE_URL = {\n  // platformAuth is the platform identity layer (workspaces, PATs);\n  // it vacated api.auth so the customer-facing Auth product could\n  // take that host.\n  platformAuth: \"https://api.platform-auth.productcraft.co\",\n  auth: \"https://api.auth.productcraft.co\",\n  mail: \"https://api.mail.productcraft.co\",\n  waitlist: \"https://api.waitlist.productcraft.co\",\n  social: \"https://social.productcraft.co\",\n  trawl: \"https://api.trawl.productcraft.co\",\n} as const;\n\n/** Environment variable holding the `pcft_` workspace API key. */\nexport const PC_API_KEY_ENV = \"PRODUCTCRAFT_API_KEY\";\n/** Environment variable holding the default Auth app slug for `auth.consumer()`. */\nexport const PC_AUTH_APP_ENV = \"PRODUCTCRAFT_AUTH_APP\";\n\n/**\n * Read an environment variable when running somewhere with a `process`\n * global (Node, Bun, Deno's Node compat). Returns `undefined` in the\n * browser or edge runtimes without `process`, and for empty values.\n * Never throws.\n */\nexport function readEnv(name: string): string | undefined {\n  const proc = (globalThis as { process?: { env?: Record<string, string | undefined> } })\n    .process;\n  if (typeof proc === \"undefined\" || !proc || !proc.env) return undefined;\n  const value = proc.env[name];\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed === \"\" ? undefined : trimmed;\n}\n\n/**\n * Resolve the credential a server-side client should present: the\n * explicit `auth` when given, otherwise `PRODUCTCRAFT_API_KEY` from the\n * environment, otherwise none. Hosts are never read from the\n * environment; override them in code with `baseUrl`.\n */\nexport function resolveAuth(auth: PCAuth | undefined): PCAuth | undefined {\n  if (auth) return auth;\n  const key = readEnv(PC_API_KEY_ENV);\n  return key ? { type: \"apiKey\", key } : undefined;\n}\n\n/**\n * Build an `openapi-fetch` middleware that adds the configured auth\n * credential as a header on every outbound request.\n */\nexport function authMiddleware(auth: PCAuth | undefined): Middleware {\n  return {\n    async onRequest({ request }) {\n      if (!auth) return undefined;\n      switch (auth.type) {\n        case \"apiKey\":\n          request.headers.set(\"Authorization\", `Bearer ${auth.key}`);\n          break;\n        case \"bearer\":\n          request.headers.set(\"Authorization\", `Bearer ${auth.token}`);\n          break;\n        case \"cookie\":\n          request.headers.set(\"Cookie\", `auth_token=${auth.value}`);\n          break;\n      }\n      return request;\n    },\n  };\n}\n\n/**\n * Construct an `openapi-fetch` client for a surface. Each surface\n * package calls this with its own generated `paths` type and default\n * base URL. The returned client is the v0 surface — every endpoint is\n * reachable through `client.GET(...)`, `client.POST(...)`, etc.\n *\n * When `config.auth` is omitted the client falls back to\n * `PRODUCTCRAFT_API_KEY` (see `resolveAuth`).\n */\nexport function makeClient<TPaths extends object>(\n  defaultBaseUrl: string,\n  config: PCClientConfig = {},\n): Client<TPaths> {\n  const client = createClient<TPaths>({\n    baseUrl: config.baseUrl ?? defaultBaseUrl,\n    fetch: config.fetch,\n  });\n  client.use(authMiddleware(resolveAuth(config.auth)));\n  return client;\n}\n"]}

package/dist/index.d.cts

@@ -36,6 +36,11 @@ type PCAuth = {
     value: string;
 };
 interface PCClientConfig {
+    /**
+     * Credential for every request. Server-side, omit it to fall back to
+     * the `PRODUCTCRAFT_API_KEY` environment variable (your `pcft_`
+     * workspace key). An explicit value always wins over the environment.
+     */
     auth?: PCAuth;
     /** Override the prod base URL — useful for dev / staging. */
     baseUrl?: string;
@@ -58,6 +63,24 @@ declare const PC_BASE_URL: {
     readonly social: "https://social.productcraft.co";
     readonly trawl: "https://api.trawl.productcraft.co";
 };
+/** Environment variable holding the `pcft_` workspace API key. */
+declare const PC_API_KEY_ENV = "PRODUCTCRAFT_API_KEY";
+/** Environment variable holding the default Auth app slug for `auth.consumer()`. */
+declare const PC_AUTH_APP_ENV = "PRODUCTCRAFT_AUTH_APP";
+/**
+ * Read an environment variable when running somewhere with a `process`
+ * global (Node, Bun, Deno's Node compat). Returns `undefined` in the
+ * browser or edge runtimes without `process`, and for empty values.
+ * Never throws.
+ */
+declare function readEnv(name: string): string | undefined;
+/**
+ * Resolve the credential a server-side client should present: the
+ * explicit `auth` when given, otherwise `PRODUCTCRAFT_API_KEY` from the
+ * environment, otherwise none. Hosts are never read from the
+ * environment; override them in code with `baseUrl`.
+ */
+declare function resolveAuth(auth: PCAuth | undefined): PCAuth | undefined;
 /**
  * Build an `openapi-fetch` middleware that adds the configured auth
  * credential as a header on every outbound request.
@@ -68,7 +91,10 @@ declare function authMiddleware(auth: PCAuth | undefined): Middleware;
  * package calls this with its own generated `paths` type and default
  * base URL. The returned client is the v0 surface — every endpoint is
  * reachable through `client.GET(...)`, `client.POST(...)`, etc.
+ *
+ * When `config.auth` is omitted the client falls back to
+ * `PRODUCTCRAFT_API_KEY` (see `resolveAuth`).
  */
 declare function makeClient<TPaths extends object>(defaultBaseUrl: string, config?: PCClientConfig): Client<TPaths>;
 
-export { type PCAuth, type PCClientConfig, PC_BASE_URL, authMiddleware, makeClient };
+export { type PCAuth, type PCClientConfig, PC_API_KEY_ENV, PC_AUTH_APP_ENV, PC_BASE_URL, authMiddleware, makeClient, readEnv, resolveAuth };

package/dist/index.d.ts

@@ -36,6 +36,11 @@ type PCAuth = {
     value: string;
 };
 interface PCClientConfig {
+    /**
+     * Credential for every request. Server-side, omit it to fall back to
+     * the `PRODUCTCRAFT_API_KEY` environment variable (your `pcft_`
+     * workspace key). An explicit value always wins over the environment.
+     */
     auth?: PCAuth;
     /** Override the prod base URL — useful for dev / staging. */
     baseUrl?: string;
@@ -58,6 +63,24 @@ declare const PC_BASE_URL: {
     readonly social: "https://social.productcraft.co";
     readonly trawl: "https://api.trawl.productcraft.co";
 };
+/** Environment variable holding the `pcft_` workspace API key. */
+declare const PC_API_KEY_ENV = "PRODUCTCRAFT_API_KEY";
+/** Environment variable holding the default Auth app slug for `auth.consumer()`. */
+declare const PC_AUTH_APP_ENV = "PRODUCTCRAFT_AUTH_APP";
+/**
+ * Read an environment variable when running somewhere with a `process`
+ * global (Node, Bun, Deno's Node compat). Returns `undefined` in the
+ * browser or edge runtimes without `process`, and for empty values.
+ * Never throws.
+ */
+declare function readEnv(name: string): string | undefined;
+/**
+ * Resolve the credential a server-side client should present: the
+ * explicit `auth` when given, otherwise `PRODUCTCRAFT_API_KEY` from the
+ * environment, otherwise none. Hosts are never read from the
+ * environment; override them in code with `baseUrl`.
+ */
+declare function resolveAuth(auth: PCAuth | undefined): PCAuth | undefined;
 /**
  * Build an `openapi-fetch` middleware that adds the configured auth
  * credential as a header on every outbound request.
@@ -68,7 +91,10 @@ declare function authMiddleware(auth: PCAuth | undefined): Middleware;
  * package calls this with its own generated `paths` type and default
  * base URL. The returned client is the v0 surface — every endpoint is
  * reachable through `client.GET(...)`, `client.POST(...)`, etc.
+ *
+ * When `config.auth` is omitted the client falls back to
+ * `PRODUCTCRAFT_API_KEY` (see `resolveAuth`).
  */
 declare function makeClient<TPaths extends object>(defaultBaseUrl: string, config?: PCClientConfig): Client<TPaths>;
 
-export { type PCAuth, type PCClientConfig, PC_BASE_URL, authMiddleware, makeClient };
+export { type PCAuth, type PCClientConfig, PC_API_KEY_ENV, PC_AUTH_APP_ENV, PC_BASE_URL, authMiddleware, makeClient, readEnv, resolveAuth };

package/dist/index.js

@@ -12,6 +12,21 @@ var PC_BASE_URL = {
   social: "https://social.productcraft.co",
   trawl: "https://api.trawl.productcraft.co"
 };
+var PC_API_KEY_ENV = "PRODUCTCRAFT_API_KEY";
+var PC_AUTH_APP_ENV = "PRODUCTCRAFT_AUTH_APP";
+function readEnv(name) {
+  const proc = globalThis.process;
+  if (typeof proc === "undefined" || !proc || !proc.env) return void 0;
+  const value = proc.env[name];
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function resolveAuth(auth) {
+  if (auth) return auth;
+  const key = readEnv(PC_API_KEY_ENV);
+  return key ? { type: "apiKey", key } : void 0;
+}
 function authMiddleware(auth) {
   return {
     async onRequest({ request }) {
@@ -36,10 +51,10 @@ function makeClient(defaultBaseUrl, config = {}) {
     baseUrl: config.baseUrl ?? defaultBaseUrl,
     fetch: config.fetch
   });
-  client.use(authMiddleware(config.auth));
+  client.use(authMiddleware(resolveAuth(config.auth)));
   return client;
 }
 
-export { PC_BASE_URL, authMiddleware, makeClient };
+export { PC_API_KEY_ENV, PC_AUTH_APP_ENV, PC_BASE_URL, authMiddleware, makeClient, readEnv, resolveAuth };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAgDO,IAAM,WAAA,GAAc;AAAA;AAAA;AAAA;AAAA,EAIzB,YAAA,EAAc,2CAAA;AAAA,EACd,IAAA,EAAM,kCAAA;AAAA,EACN,IAAA,EAAM,kCAAA;AAAA,EACN,QAAA,EAAU,sCAAA;AAAA,EACV,MAAA,EAAQ,gCAAA;AAAA,EACR,KAAA,EAAO;AACT;AAMO,SAAS,eAAe,IAAA,EAAsC;AACnE,EAAA,OAAO;AAAA,IACL,MAAM,SAAA,CAAU,EAAE,OAAA,EAAQ,EAAG;AAC3B,MAAA,IAAI,CAAC,MAAM,OAAO,MAAA;AAClB,MAAA,QAAQ,KAAK,IAAA;AAAM,QACjB,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AACzD,UAAA;AAAA,QACF,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AAC3D,UAAA;AAAA,QACF,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,QAAA,EAAU,CAAA,WAAA,EAAc,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AACxD,UAAA;AAAA;AAEJ,MAAA,OAAO,OAAA;AAAA,IACT;AAAA,GACF;AACF;AAQO,SAAS,UAAA,CACd,cAAA,EACA,MAAA,GAAyB,EAAC,EACV;AAChB,EAAA,MAAM,SAAS,YAAA,CAAqB;AAAA,IAClC,OAAA,EAAS,OAAO,OAAA,IAAW,cAAA;AAAA,IAC3B,OAAO,MAAA,CAAO;AAAA,GACf,CAAA;AACD,EAAA,MAAA,CAAO,GAAA,CAAI,cAAA,CAAe,MAAA,CAAO,IAAI,CAAC,CAAA;AACtC,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["/**\n * Shared transport + auth plumbing used by every surface client.\n *\n * Each surface package (`@productcraft/auth`, `@productcraft/mail`,\n * ...) defines a thin class around `openapi-fetch` plus the generated\n * `paths` types from its own `_generated.d.ts`. The class delegates\n * wire I/O to `openapi-fetch`, but exposes a Stripe-style ergonomic\n * surface where callers reach for `pc.mail.messages.send(...)` rather\n * than the underlying `client.POST(\"/v1/...\")` shape.\n *\n * v0 ships only the underlying `client` (named `client` on each\n * surface) — every endpoint is reachable through it. Ergonomic\n * resource surfaces land in v0.1+ as we hand-roll them.\n */\n\nimport createClient, { type Client, type Middleware } from \"openapi-fetch\";\n\n/**\n * The auth credential the SDK presents to ProductCraft APIs.\n *\n * - `apiKey` — Platform API Key (`pcft_live_*`). Server-side only;\n *   never embed in a shipped browser bundle.\n * - `bearer` — pre-resolved JWT (e.g. an Auth app-scoped EndUser\n *   token your backend minted and shipped to the device).\n * - `cookie` — captured `auth_token` cookie value. Mostly useful in\n *   dev / E2E tests where you've already signed in.\n */\nexport type PCAuth =\n  | { type: \"apiKey\"; key: string }\n  | { type: \"bearer\"; token: string }\n  | { type: \"cookie\"; value: string };\n\nexport interface PCClientConfig {\n  auth?: PCAuth;\n  /** Override the prod base URL — useful for dev / staging. */\n  baseUrl?: string;\n  /** Custom fetch (e.g. node-fetch with retries, undici, ...). */\n  fetch?: typeof fetch;\n}\n\n/**\n * Default prod base URL per surface.\n *\n * Keys use the rebranded product names (Auth, Mail, Waitlist, Social)\n * matching the package + class names since the 2026-07 SDK rename.\n * Prior releases (`@productcraft/heimdall` 0.x etc.) exposed the same\n * hosts under the old keys (heimdall/envoi/rally/agora).\n */\nexport const PC_BASE_URL = {\n  // platformAuth is the platform identity layer (workspaces, PATs);\n  // it vacated api.auth so the customer-facing Auth product could\n  // take that host.\n  platformAuth: \"https://api.platform-auth.productcraft.co\",\n  auth: \"https://api.auth.productcraft.co\",\n  mail: \"https://api.mail.productcraft.co\",\n  waitlist: \"https://api.waitlist.productcraft.co\",\n  social: \"https://social.productcraft.co\",\n  trawl: \"https://api.trawl.productcraft.co\",\n} as const;\n\n/**\n * Build an `openapi-fetch` middleware that adds the configured auth\n * credential as a header on every outbound request.\n */\nexport function authMiddleware(auth: PCAuth | undefined): Middleware {\n  return {\n    async onRequest({ request }) {\n      if (!auth) return undefined;\n      switch (auth.type) {\n        case \"apiKey\":\n          request.headers.set(\"Authorization\", `Bearer ${auth.key}`);\n          break;\n        case \"bearer\":\n          request.headers.set(\"Authorization\", `Bearer ${auth.token}`);\n          break;\n        case \"cookie\":\n          request.headers.set(\"Cookie\", `auth_token=${auth.value}`);\n          break;\n      }\n      return request;\n    },\n  };\n}\n\n/**\n * Construct an `openapi-fetch` client for a surface. Each surface\n * package calls this with its own generated `paths` type and default\n * base URL. The returned client is the v0 surface — every endpoint is\n * reachable through `client.GET(...)`, `client.POST(...)`, etc.\n */\nexport function makeClient<TPaths extends object>(\n  defaultBaseUrl: string,\n  config: PCClientConfig = {},\n): Client<TPaths> {\n  const client = createClient<TPaths>({\n    baseUrl: config.baseUrl ?? defaultBaseUrl,\n    fetch: config.fetch,\n  });\n  client.use(authMiddleware(config.auth));\n  return client;\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAqDO,IAAM,WAAA,GAAc;AAAA;AAAA;AAAA;AAAA,EAIzB,YAAA,EAAc,2CAAA;AAAA,EACd,IAAA,EAAM,kCAAA;AAAA,EACN,IAAA,EAAM,kCAAA;AAAA,EACN,QAAA,EAAU,sCAAA;AAAA,EACV,MAAA,EAAQ,gCAAA;AAAA,EACR,KAAA,EAAO;AACT;AAGO,IAAM,cAAA,GAAiB;AAEvB,IAAM,eAAA,GAAkB;AAQxB,SAAS,QAAQ,IAAA,EAAkC;AACxD,EAAA,MAAM,OAAQ,UAAA,CACX,OAAA;AACH,EAAA,IAAI,OAAO,SAAS,WAAA,IAAe,CAAC,QAAQ,CAAC,IAAA,CAAK,KAAK,OAAO,MAAA;AAC9D,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA;AAC3B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,MAAA;AACtC,EAAA,MAAM,OAAA,GAAU,MAAM,IAAA,EAAK;AAC3B,EAAA,OAAO,OAAA,KAAY,KAAK,MAAA,GAAY,OAAA;AACtC;AAQO,SAAS,YAAY,IAAA,EAA8C;AACxE,EAAA,IAAI,MAAM,OAAO,IAAA;AACjB,EAAA,MAAM,GAAA,GAAM,QAAQ,cAAc,CAAA;AAClC,EAAA,OAAO,GAAA,GAAM,EAAE,IAAA,EAAM,QAAA,EAAU,KAAI,GAAI,MAAA;AACzC;AAMO,SAAS,eAAe,IAAA,EAAsC;AACnE,EAAA,OAAO;AAAA,IACL,MAAM,SAAA,CAAU,EAAE,OAAA,EAAQ,EAAG;AAC3B,MAAA,IAAI,CAAC,MAAM,OAAO,MAAA;AAClB,MAAA,QAAQ,KAAK,IAAA;AAAM,QACjB,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AACzD,UAAA;AAAA,QACF,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AAC3D,UAAA;AAAA,QACF,KAAK,QAAA;AACH,UAAA,OAAA,CAAQ,QAAQ,GAAA,CAAI,QAAA,EAAU,CAAA,WAAA,EAAc,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AACxD,UAAA;AAAA;AAEJ,MAAA,OAAO,OAAA;AAAA,IACT;AAAA,GACF;AACF;AAWO,SAAS,UAAA,CACd,cAAA,EACA,MAAA,GAAyB,EAAC,EACV;AAChB,EAAA,MAAM,SAAS,YAAA,CAAqB;AAAA,IAClC,OAAA,EAAS,OAAO,OAAA,IAAW,cAAA;AAAA,IAC3B,OAAO,MAAA,CAAO;AAAA,GACf,CAAA;AACD,EAAA,MAAA,CAAO,IAAI,cAAA,CAAe,WAAA,CAAY,MAAA,CAAO,IAAI,CAAC,CAAC,CAAA;AACnD,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["/**\n * Shared transport + auth plumbing used by every surface client.\n *\n * Each surface package (`@productcraft/auth`, `@productcraft/mail`,\n * ...) defines a thin class around `openapi-fetch` plus the generated\n * `paths` types from its own `_generated.d.ts`. The class delegates\n * wire I/O to `openapi-fetch`, but exposes a Stripe-style ergonomic\n * surface where callers reach for `pc.mail.messages.send(...)` rather\n * than the underlying `client.POST(\"/v1/...\")` shape.\n *\n * v0 ships only the underlying `client` (named `client` on each\n * surface) — every endpoint is reachable through it. Ergonomic\n * resource surfaces land in v0.1+ as we hand-roll them.\n */\n\nimport createClient, { type Client, type Middleware } from \"openapi-fetch\";\n\n/**\n * The auth credential the SDK presents to ProductCraft APIs.\n *\n * - `apiKey` — Platform API Key (`pcft_live_*`). Server-side only;\n *   never embed in a shipped browser bundle.\n * - `bearer` — pre-resolved JWT (e.g. an Auth app-scoped EndUser\n *   token your backend minted and shipped to the device).\n * - `cookie` — captured `auth_token` cookie value. Mostly useful in\n *   dev / E2E tests where you've already signed in.\n */\nexport type PCAuth =\n  | { type: \"apiKey\"; key: string }\n  | { type: \"bearer\"; token: string }\n  | { type: \"cookie\"; value: string };\n\nexport interface PCClientConfig {\n  /**\n   * Credential for every request. Server-side, omit it to fall back to\n   * the `PRODUCTCRAFT_API_KEY` environment variable (your `pcft_`\n   * workspace key). An explicit value always wins over the environment.\n   */\n  auth?: PCAuth;\n  /** Override the prod base URL — useful for dev / staging. */\n  baseUrl?: string;\n  /** Custom fetch (e.g. node-fetch with retries, undici, ...). */\n  fetch?: typeof fetch;\n}\n\n/**\n * Default prod base URL per surface.\n *\n * Keys use the rebranded product names (Auth, Mail, Waitlist, Social)\n * matching the package + class names since the 2026-07 SDK rename.\n * Prior releases (`@productcraft/heimdall` 0.x etc.) exposed the same\n * hosts under the old keys (heimdall/envoi/rally/agora).\n */\nexport const PC_BASE_URL = {\n  // platformAuth is the platform identity layer (workspaces, PATs);\n  // it vacated api.auth so the customer-facing Auth product could\n  // take that host.\n  platformAuth: \"https://api.platform-auth.productcraft.co\",\n  auth: \"https://api.auth.productcraft.co\",\n  mail: \"https://api.mail.productcraft.co\",\n  waitlist: \"https://api.waitlist.productcraft.co\",\n  social: \"https://social.productcraft.co\",\n  trawl: \"https://api.trawl.productcraft.co\",\n} as const;\n\n/** Environment variable holding the `pcft_` workspace API key. */\nexport const PC_API_KEY_ENV = \"PRODUCTCRAFT_API_KEY\";\n/** Environment variable holding the default Auth app slug for `auth.consumer()`. */\nexport const PC_AUTH_APP_ENV = \"PRODUCTCRAFT_AUTH_APP\";\n\n/**\n * Read an environment variable when running somewhere with a `process`\n * global (Node, Bun, Deno's Node compat). Returns `undefined` in the\n * browser or edge runtimes without `process`, and for empty values.\n * Never throws.\n */\nexport function readEnv(name: string): string | undefined {\n  const proc = (globalThis as { process?: { env?: Record<string, string | undefined> } })\n    .process;\n  if (typeof proc === \"undefined\" || !proc || !proc.env) return undefined;\n  const value = proc.env[name];\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed === \"\" ? undefined : trimmed;\n}\n\n/**\n * Resolve the credential a server-side client should present: the\n * explicit `auth` when given, otherwise `PRODUCTCRAFT_API_KEY` from the\n * environment, otherwise none. Hosts are never read from the\n * environment; override them in code with `baseUrl`.\n */\nexport function resolveAuth(auth: PCAuth | undefined): PCAuth | undefined {\n  if (auth) return auth;\n  const key = readEnv(PC_API_KEY_ENV);\n  return key ? { type: \"apiKey\", key } : undefined;\n}\n\n/**\n * Build an `openapi-fetch` middleware that adds the configured auth\n * credential as a header on every outbound request.\n */\nexport function authMiddleware(auth: PCAuth | undefined): Middleware {\n  return {\n    async onRequest({ request }) {\n      if (!auth) return undefined;\n      switch (auth.type) {\n        case \"apiKey\":\n          request.headers.set(\"Authorization\", `Bearer ${auth.key}`);\n          break;\n        case \"bearer\":\n          request.headers.set(\"Authorization\", `Bearer ${auth.token}`);\n          break;\n        case \"cookie\":\n          request.headers.set(\"Cookie\", `auth_token=${auth.value}`);\n          break;\n      }\n      return request;\n    },\n  };\n}\n\n/**\n * Construct an `openapi-fetch` client for a surface. Each surface\n * package calls this with its own generated `paths` type and default\n * base URL. The returned client is the v0 surface — every endpoint is\n * reachable through `client.GET(...)`, `client.POST(...)`, etc.\n *\n * When `config.auth` is omitted the client falls back to\n * `PRODUCTCRAFT_API_KEY` (see `resolveAuth`).\n */\nexport function makeClient<TPaths extends object>(\n  defaultBaseUrl: string,\n  config: PCClientConfig = {},\n): Client<TPaths> {\n  const client = createClient<TPaths>({\n    baseUrl: config.baseUrl ?? defaultBaseUrl,\n    fetch: config.fetch,\n  });\n  client.use(authMiddleware(resolveAuth(config.auth)));\n  return client;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productcraft/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Shared transport, auth, and config primitives for the ProductCraft SDKs. Depended on by every per-surface package.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -33,6 +33,9 @@
     "directory": "packages/core"
   },
   "homepage": "https://github.com/clauderanelagh/productcraft-node/tree/main/packages/core",
+  "bugs": {
+    "url": "https://github.com/clauderanelagh/productcraft-node/issues"
+  },
   "publishConfig": {
     "access": "public",
     "provenance": true