@journeybee/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Journeybee
+
+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,113 @@
+# @journeybee/sdk
+
+TypeScript SDK for the [Journeybee](https://journeybee.io) PRM API. Auto-generated from the OpenAPI spec with full type safety.
+
+## Install
+
+```bash
+npm install @journeybee/sdk
+```
+
+## Quick Start
+
+```typescript
+import { client, listPartners, getLead, createLead } from "@journeybee/sdk";
+
+// Configure once
+client.setConfig({
+  baseUrl: "https://api.journeybee.io/v1",
+  auth: "your-api-key",
+});
+
+// List partners
+const { data: partners } = await listPartners({
+  query: { search: "Acme", per_page: 10 },
+});
+
+// Get a lead
+const { data: lead } = await getLead({
+  path: { uuid: "lead-uuid" },
+});
+
+// Create a lead
+const { data: newLead } = await createLead({
+  body: {
+    first_name: "Jane",
+    last_name: "Smith",
+    email: "jane@acme.com",
+    partnership_uuid: "partner-uuid",
+  },
+});
+```
+
+## Authentication
+
+Get your API key from **Settings > API Keys** in the Journeybee app.
+
+```typescript
+client.setConfig({
+  baseUrl: "https://api.journeybee.io/v1",
+  auth: "your-api-key",
+});
+```
+
+### Multi-tenant / per-request clients
+
+The default singleton is fine for single-tenant servers and CLI tools. For multi-tenant servers (one Node process handling multiple users) use `createClient` to build per-request clients instead of mutating the singleton:
+
+```typescript
+import { createClient, createConfig, listPartners } from "@journeybee/sdk";
+
+const userClient = createClient(
+  createConfig({
+    baseUrl: "https://api.journeybee.io/v1",
+    auth: userApiKey,
+  }),
+);
+
+const { data } = await listPartners({ client: userClient });
+```
+
+Every SDK function accepts an optional `client` option that overrides the default. This is how `@journeybee/mcp`'s HTTP transport handles per-request auth safely.
+
+## Environment variables
+
+**None.** `@journeybee/sdk` is a library consumed by other code — it has zero runtime env var reads. Configuration happens in code via `client.setConfig()` or per-call `client` options. If you need an env-based config, wire it up in your own app (the MCP server is a good example).
+
+## Available Functions
+
+Every API endpoint has a corresponding typed function:
+
+| Pattern   | Example                                     |
+| --------- | ------------------------------------------- |
+| `listX`   | `listPartners`, `listLeads`, `listDeals`    |
+| `getX`    | `getPartner`, `getLead`, `getDeal`          |
+| `createX` | `createPartner`, `createLead`, `createDeal` |
+| `updateX` | `updatePartner`, `updateLead`, `updateDeal` |
+| `deleteX` | `deletePartner`, `deleteLead`, `deleteDeal` |
+
+Plus sub-resource functions: `addLeadTag`, `removeLeadTag`, `createPartnerContact`, `addResourceBlock`, etc.
+
+## Error Handling
+
+```typescript
+const { data, error } = await getLead({ path: { uuid: "..." } });
+
+if (error) {
+  console.error(error.code, error.message);
+  // error.code: "not_found" | "validation_error" | "unauthorized" | ...
+  return;
+}
+
+console.log(data.first_name);
+```
+
+## Documentation
+
+- [API Reference](https://docs.journeybee.io/api-reference)
+- [Authentication Guide](https://docs.journeybee.io/guides/authentication)
+- [MCP Server](https://docs.journeybee.io/guides/mcp)
+
+## License
+
+MIT

package/dist/generated/client.gen.d.ts

@@ -0,0 +1,13 @@
+import type { ClientOptions } from './types.gen';
+import { type Config, type ClientOptions as DefaultClientOptions } from '@hey-api/client-fetch';
+/**
+ * The `createClientConfig()` function will be called on client initialization
+ * and the returned object will become the client's initial configuration.
+ *
+ * You may want to initialize your client this way instead of calling
+ * `setConfig()`. This is useful for example if you're using Next.js
+ * to ensure your client always has the correct values.
+ */
+export type CreateClientConfig<T extends DefaultClientOptions = ClientOptions> = (override?: Config<DefaultClientOptions & T>) => Config<Required<DefaultClientOptions> & T>;
+export declare const client: import("@hey-api/client-fetch").Client;
+//# sourceMappingURL=client.gen.d.ts.map

package/dist/generated/client.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.gen.d.ts","sourceRoot":"","sources":["../../src/generated/client.gen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,IAAI,oBAAoB,EAA8B,MAAM,uBAAuB,CAAC;AAE5H;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,oBAAoB,GAAG,aAAa,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,oBAAoB,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;AAE7K,eAAO,MAAM,MAAM,wCAEhB,CAAC"}

package/dist/generated/client.gen.js

@@ -0,0 +1,6 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { createClient, createConfig } from '@hey-api/client-fetch';
+export const client = createClient(createConfig({
+    baseUrl: 'https://api.journeybee.io/v1'
+}));
+//# sourceMappingURL=client.gen.js.map

package/dist/generated/client.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.gen.js","sourceRoot":"","sources":["../../src/generated/client.gen.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAGrD,OAAO,EAA2D,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAY5H,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAgB;IAC3D,OAAO,EAAE,8BAA8B;CAC1C,CAAC,CAAC,CAAC"}

package/dist/generated/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.gen';
+export * from './sdk.gen';
+//# sourceMappingURL=index.d.ts.map

package/dist/generated/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/generated/index.js

@@ -0,0 +1,4 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export * from './types.gen';
+export * from './sdk.gen';
+//# sourceMappingURL=index.js.map

package/dist/generated/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}