productcraft 0.0.1 → 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ProductCraft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# productcraft
+
+All-in-one Node.js / TypeScript SDK for the [ProductCraft](https://productcraft.co) platform. One install, one auth credential, every surface.
+
+```bash
+npm install productcraft
+```
+
+## When to use this
+
+Install **`productcraft`** when you call more than one ProductCraft API from the same backend (e.g. you mint Heimdall tokens *and* send transactional email through Envoi). It's a thin wrapper that instantiates one of each per-surface client and shares your auth credential across them.
+
+Install the **per-product packages** when you only need one:
+
+- `@productcraft/heimdall` — customer auth + EndUsers
+- `@productcraft/envoi` — transactional email
+- `@productcraft/rally` — waitlists
+- `@productcraft/agora` — landing pages
+- `@productcraft/platform-auth` — workspace administration
+
+The per-product packages are leaner (no bundled deps for the surfaces you don't use).
+
+## Quick start
+
+```ts
+import { ProductCraft } from "productcraft";
+
+const pc = new ProductCraft({
+  auth: { type: "apiKey", key: process.env.PCFT_KEY! },
+});
+
+// Heimdall — sign in an EndUser through the BFF flow
+const consumer = pc.heimdall.consumer("my-app-slug");
+const tokens = await consumer.auth.signin({
+  identifier: "alice@example.com",
+  password: "...",
+});
+
+// Envoi — send a transactional email from the same backend
+await pc.envoi.client.POST(
+  "/v1/mailboxes/{mailboxId}/messages/send",
+  {
+    params: { path: { mailboxId: "mbx_..." } },
+    body: {
+      to: "alice@example.com",
+      from: "hello@yourbrand.com",
+      subject: "Welcome",
+      html: "<p>Hi!</p>",
+    },
+  },
+);
+
+// Rally — accept a waitlist signup
+await pc.rally.client.POST(
+  "/v1/waitlists/{workspaceSlug}/{waitlistSlug}/entries",
+  {
+    params: { path: { workspaceSlug: "my-workspace", waitlistSlug: "early-access" } },
+    body: { email: "alice@example.com" },
+  },
+);
+```
+
+## What gets instantiated
+
+```ts
+class ProductCraft {
+  readonly heimdall: Heimdall;       // @productcraft/heimdall
+  readonly envoi: Envoi;              // @productcraft/envoi
+  readonly rally: Rally;              // @productcraft/rally
+  readonly agora: Agora;              // @productcraft/agora
+  readonly platformAuth: PlatformAuth; // @productcraft/platform-auth
+}
+```
+
+Each is the same class you'd get from installing its per-product package directly — `pc.heimdall` is `new Heimdall(config)`, etc. The classes are re-exported so you can refer to their types: `import type { Heimdall } from "productcraft"`.
+
+## Configuration
+
+```ts
+new ProductCraft({
+  // Shared auth credential — applied to every surface
+  auth: { type: "apiKey", key: "pcft_live_..." }
+      | { type: "bearer", token: "eyJ..." }
+      | { type: "cookie", value: "auth_token=..." },
+
+  // Shared overrides (optional)
+  baseUrl: "...",   // RARELY useful — surfaces have different base URLs
+  fetch: customFetch,
+
+  // Per-surface overrides — useful for dev / staging
+  heimdall:     { baseUrl: "https://api.heimdall.example.test" },
+  envoi:        { baseUrl: "https://api.mail.example.test" },
+  rally:        { baseUrl: "https://api.rally.example.test" },
+  agora:        { baseUrl: "https://agora.example.test" },
+  platformAuth: { baseUrl: "https://api.auth.example.test" },
+});
+```
+
+A per-surface override is merged over the shared config — you can change just the base URL of one surface (e.g. pointing Heimdall at a staging cluster while Envoi stays on prod) without restating the whole credential.
+
+## How these SDKs are built
+
+Every surface is generated from its live OpenAPI spec via [`openapi-typescript`](https://openapi-ts.dev/) (types) + [`openapi-fetch`](https://openapi-ts.dev/openapi-fetch/) (runtime). Heimdall additionally has a hand-written ergonomic layer (`consumer(slug).auth.signin(...)`) on top of the generated client; the other surfaces ship the `client` directly for now.
+
+## License
+
+[MIT](https://github.com/clauderanelagh/productcraft-node/blob/main/LICENSE).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "productcraft",
-  "version": "0.0.1",
-  "description": "All-in-one Node.js / TypeScript SDK for the ProductCraft platform \u2014 Heimdall, Envoi, Rally, Agora, and Platform-Auth from a single import. Install per-product packages (`@productcraft/heimdall`, ...) if you only need one.",
+  "version": "0.0.3",
+  "description": "All-in-one Node.js / TypeScript SDK for the ProductCraft platform — Heimdall, Envoi, Rally, Agora, and Platform-Auth from a single import. Install per-product packages (`@productcraft/heimdall`, ...) if you only need one.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -21,10 +21,6 @@
   "engines": {
     "node": ">=18"
   },
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run"
-  },
   "keywords": [
     "productcraft",
     "sdk",
@@ -46,14 +42,19 @@
   },
   "homepage": "https://github.com/clauderanelagh/productcraft-node",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "dependencies": {
-    "@productcraft/agora": "workspace:^",
-    "@productcraft/core": "workspace:^",
-    "@productcraft/envoi": "workspace:^",
-    "@productcraft/heimdall": "workspace:^",
-    "@productcraft/platform-auth": "workspace:^",
-    "@productcraft/rally": "workspace:^"
+    "@productcraft/agora": "^0.0.3",
+    "@productcraft/core": "^0.0.3",
+    "@productcraft/envoi": "^0.0.3",
+    "@productcraft/heimdall": "^0.1.0",
+    "@productcraft/platform-auth": "^0.0.3",
+    "@productcraft/rally": "^0.0.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
   }
-}
+}