@productcraft/core 0.0.1

package/dist/index.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+var createClient = require('openapi-fetch');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var createClient__default = /*#__PURE__*/_interopDefault(createClient);
+
+// src/index.ts
+var PC_BASE_URL = {
+  platformAuth: "https://api.auth.productcraft.co",
+  heimdall: "https://api.heimdall.productcraft.co",
+  envoi: "https://api.mail.productcraft.co",
+  rally: "https://api.rally.productcraft.co",
+  agora: "https://agora.productcraft.co"
+};
+function authMiddleware(auth) {
+  return {
+    async onRequest({ request }) {
+      if (!auth) return void 0;
+      switch (auth.type) {
+        case "apiKey":
+          request.headers.set("Authorization", `Bearer ${auth.key}`);
+          break;
+        case "bearer":
+          request.headers.set("Authorization", `Bearer ${auth.token}`);
+          break;
+        case "cookie":
+          request.headers.set("Cookie", `auth_token=${auth.value}`);
+          break;
+      }
+      return request;
+    }
+  };
+}
+function makeClient(defaultBaseUrl, config = {}) {
+  const client = createClient__default.default({
+    baseUrl: config.baseUrl ?? defaultBaseUrl,
+    fetch: config.fetch
+  });
+  client.use(authMiddleware(config.auth));
+  return client;
+}
+
+exports.PC_BASE_URL = PC_BASE_URL;
+exports.authMiddleware = authMiddleware;
+exports.makeClient = makeClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["createClient"],"mappings":";;;;;;;;;AAyCO,IAAM,WAAA,GAAc;AAAA,EACzB,YAAA,EAAc,kCAAA;AAAA,EACd,QAAA,EAAU,sCAAA;AAAA,EACV,KAAA,EAAO,kCAAA;AAAA,EACP,KAAA,EAAO,mCAAA;AAAA,EACP,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/heimdall`, `@productcraft/envoi`,\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.envoi.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. a Heimdall 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/** Default prod base URL per surface. */\nexport const PC_BASE_URL = {\n  platformAuth: \"https://api.auth.productcraft.co\",\n  heimdall: \"https://api.heimdall.productcraft.co\",\n  envoi: \"https://api.mail.productcraft.co\",\n  rally: \"https://api.rally.productcraft.co\",\n  agora: \"https://agora.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"]}

package/dist/index.d.cts

@@ -0,0 +1,66 @@
+import { Middleware, Client } from 'openapi-fetch';
+
+/**
+ * Shared transport + auth plumbing used by every surface client.
+ *
+ * Each surface package (`@productcraft/heimdall`, `@productcraft/envoi`,
+ * ...) defines a thin class around `openapi-fetch` plus the generated
+ * `paths` types from its own `_generated.d.ts`. The class delegates
+ * wire I/O to `openapi-fetch`, but exposes a Stripe-style ergonomic
+ * surface where callers reach for `pc.envoi.messages.send(...)` rather
+ * than the underlying `client.POST("/v1/...")` shape.
+ *
+ * v0 ships only the underlying `client` (named `client` on each
+ * surface) — every endpoint is reachable through it. Ergonomic
+ * resource surfaces land in v0.1+ as we hand-roll them.
+ */
+
+/**
+ * The auth credential the SDK presents to ProductCraft APIs.
+ *
+ * - `apiKey` — Platform API Key (`pcft_live_*`). Server-side only;
+ *   never embed in a shipped browser bundle.
+ * - `bearer` — pre-resolved JWT (e.g. a Heimdall app-scoped EndUser
+ *   token your backend minted and shipped to the device).
+ * - `cookie` — captured `auth_token` cookie value. Mostly useful in
+ *   dev / E2E tests where you've already signed in.
+ */
+type PCAuth = {
+    type: "apiKey";
+    key: string;
+} | {
+    type: "bearer";
+    token: string;
+} | {
+    type: "cookie";
+    value: string;
+};
+interface PCClientConfig {
+    auth?: PCAuth;
+    /** Override the prod base URL — useful for dev / staging. */
+    baseUrl?: string;
+    /** Custom fetch (e.g. node-fetch with retries, undici, ...). */
+    fetch?: typeof fetch;
+}
+/** Default prod base URL per surface. */
+declare const PC_BASE_URL: {
+    readonly platformAuth: "https://api.auth.productcraft.co";
+    readonly heimdall: "https://api.heimdall.productcraft.co";
+    readonly envoi: "https://api.mail.productcraft.co";
+    readonly rally: "https://api.rally.productcraft.co";
+    readonly agora: "https://agora.productcraft.co";
+};
+/**
+ * Build an `openapi-fetch` middleware that adds the configured auth
+ * credential as a header on every outbound request.
+ */
+declare function authMiddleware(auth: PCAuth | undefined): Middleware;
+/**
+ * Construct an `openapi-fetch` client for a surface. Each surface
+ * 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.
+ */
+declare function makeClient<TPaths extends object>(defaultBaseUrl: string, config?: PCClientConfig): Client<TPaths>;
+
+export { type PCAuth, type PCClientConfig, PC_BASE_URL, authMiddleware, makeClient };

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+import { Middleware, Client } from 'openapi-fetch';
+
+/**
+ * Shared transport + auth plumbing used by every surface client.
+ *
+ * Each surface package (`@productcraft/heimdall`, `@productcraft/envoi`,
+ * ...) defines a thin class around `openapi-fetch` plus the generated
+ * `paths` types from its own `_generated.d.ts`. The class delegates
+ * wire I/O to `openapi-fetch`, but exposes a Stripe-style ergonomic
+ * surface where callers reach for `pc.envoi.messages.send(...)` rather
+ * than the underlying `client.POST("/v1/...")` shape.
+ *
+ * v0 ships only the underlying `client` (named `client` on each
+ * surface) — every endpoint is reachable through it. Ergonomic
+ * resource surfaces land in v0.1+ as we hand-roll them.
+ */
+
+/**
+ * The auth credential the SDK presents to ProductCraft APIs.
+ *
+ * - `apiKey` — Platform API Key (`pcft_live_*`). Server-side only;
+ *   never embed in a shipped browser bundle.
+ * - `bearer` — pre-resolved JWT (e.g. a Heimdall app-scoped EndUser
+ *   token your backend minted and shipped to the device).
+ * - `cookie` — captured `auth_token` cookie value. Mostly useful in
+ *   dev / E2E tests where you've already signed in.
+ */
+type PCAuth = {
+    type: "apiKey";
+    key: string;
+} | {
+    type: "bearer";
+    token: string;
+} | {
+    type: "cookie";
+    value: string;
+};
+interface PCClientConfig {
+    auth?: PCAuth;
+    /** Override the prod base URL — useful for dev / staging. */
+    baseUrl?: string;
+    /** Custom fetch (e.g. node-fetch with retries, undici, ...). */
+    fetch?: typeof fetch;
+}
+/** Default prod base URL per surface. */
+declare const PC_BASE_URL: {
+    readonly platformAuth: "https://api.auth.productcraft.co";
+    readonly heimdall: "https://api.heimdall.productcraft.co";
+    readonly envoi: "https://api.mail.productcraft.co";
+    readonly rally: "https://api.rally.productcraft.co";
+    readonly agora: "https://agora.productcraft.co";
+};
+/**
+ * Build an `openapi-fetch` middleware that adds the configured auth
+ * credential as a header on every outbound request.
+ */
+declare function authMiddleware(auth: PCAuth | undefined): Middleware;
+/**
+ * Construct an `openapi-fetch` client for a surface. Each surface
+ * 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.
+ */
+declare function makeClient<TPaths extends object>(defaultBaseUrl: string, config?: PCClientConfig): Client<TPaths>;
+
+export { type PCAuth, type PCClientConfig, PC_BASE_URL, authMiddleware, makeClient };

package/dist/index.js

@@ -0,0 +1,41 @@
+import createClient from 'openapi-fetch';
+
+// src/index.ts
+var PC_BASE_URL = {
+  platformAuth: "https://api.auth.productcraft.co",
+  heimdall: "https://api.heimdall.productcraft.co",
+  envoi: "https://api.mail.productcraft.co",
+  rally: "https://api.rally.productcraft.co",
+  agora: "https://agora.productcraft.co"
+};
+function authMiddleware(auth) {
+  return {
+    async onRequest({ request }) {
+      if (!auth) return void 0;
+      switch (auth.type) {
+        case "apiKey":
+          request.headers.set("Authorization", `Bearer ${auth.key}`);
+          break;
+        case "bearer":
+          request.headers.set("Authorization", `Bearer ${auth.token}`);
+          break;
+        case "cookie":
+          request.headers.set("Cookie", `auth_token=${auth.value}`);
+          break;
+      }
+      return request;
+    }
+  };
+}
+function makeClient(defaultBaseUrl, config = {}) {
+  const client = createClient({
+    baseUrl: config.baseUrl ?? defaultBaseUrl,
+    fetch: config.fetch
+  });
+  client.use(authMiddleware(config.auth));
+  return client;
+}
+
+export { PC_BASE_URL, authMiddleware, makeClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAyCO,IAAM,WAAA,GAAc;AAAA,EACzB,YAAA,EAAc,kCAAA;AAAA,EACd,QAAA,EAAU,sCAAA;AAAA,EACV,KAAA,EAAO,kCAAA;AAAA,EACP,KAAA,EAAO,mCAAA;AAAA,EACP,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/heimdall`, `@productcraft/envoi`,\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.envoi.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. a Heimdall 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/** Default prod base URL per surface. */\nexport const PC_BASE_URL = {\n  platformAuth: \"https://api.auth.productcraft.co\",\n  heimdall: \"https://api.heimdall.productcraft.co\",\n  envoi: \"https://api.mail.productcraft.co\",\n  rally: \"https://api.rally.productcraft.co\",\n  agora: \"https://agora.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"]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@productcraft/core",
+  "version": "0.0.1",
+  "description": "Shared transport, auth, and config primitives for the ProductCraft SDKs. Depended on by every per-surface package.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup"
+  },
+  "keywords": [
+    "productcraft",
+    "sdk"
+  ],
+  "author": "ProductCraft",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clauderanelagh/productcraft-node.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/clauderanelagh/productcraft-node/tree/main/packages/core",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "openapi-fetch": "^0.13.0"
+  }
+}