benji-sdk 0.1.0 → 0.1.2

package/dist/env.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Initialize the Benji SDK from environment variables.
+ *
+ * Reads `BENJI_API_KEY` (required) and `BENJI_BASE_URL` (optional) from
+ * the environment and calls `configure()`.
+ *
+ * @throws {BenjiConfigError} if BENJI_API_KEY is not set
+ */
+export declare function initializeFromEnv(): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CASxC"}

package/dist/env.js

@@ -0,0 +1,18 @@
+import { configure } from "./index.js";
+import { BenjiConfigError } from "./errors.js";
+/**
+ * Initialize the Benji SDK from environment variables.
+ *
+ * Reads `BENJI_API_KEY` (required) and `BENJI_BASE_URL` (optional) from
+ * the environment and calls `configure()`.
+ *
+ * @throws {BenjiConfigError} if BENJI_API_KEY is not set
+ */
+export function initializeFromEnv() {
+    const apiKey = process.env.BENJI_API_KEY;
+    if (!apiKey) {
+        throw new BenjiConfigError('BENJI_API_KEY environment variable is required. Get your API key from https://app.benji.so/settings');
+    }
+    const baseUrl = process.env.BENJI_BASE_URL;
+    configure({ apiKey, baseUrl });
+}

package/dist/errors.d.ts

@@ -0,0 +1,22 @@
+export declare class BenjiError extends Error {
+    constructor(message: string);
+}
+export declare class BenjiConfigError extends BenjiError {
+    constructor(message: string);
+}
+export declare class BenjiApiError extends BenjiError {
+    readonly status: number;
+    readonly code: string;
+    readonly issues?: Array<{
+        message: string;
+    }>;
+    constructor(options: {
+        status: number;
+        code: string;
+        message: string;
+        issues?: Array<{
+            message: string;
+        }>;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,UAAU;IAC3C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAExC,OAAO,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrC;CAOF"}

package/dist/errors.js

@@ -0,0 +1,21 @@
+export class BenjiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BenjiError';
+    }
+}
+export class BenjiConfigError extends BenjiError {
+    constructor(message) {
+        super(message);
+        this.name = 'BenjiConfigError';
+    }
+}
+export class BenjiApiError extends BenjiError {
+    constructor(options) {
+        super(options.message);
+        this.name = 'BenjiApiError';
+        this.status = options.status;
+        this.code = options.code;
+        this.issues = options.issues;
+    }
+}

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export * from "./client";
-import { client } from "./client/client.gen";
+export * from "./client/index.js";
+import { client } from "./client/client.gen.js";
 export interface BenjiConfig {
     /** Your Benji API key */
     apiKey: string;
-    /** Optional custom base URL (defaults to https://app.benji.so/api/rest) */
+    /** Optional custom base URL (defaults to https://alpha.benji.so/api/rest) */
     baseUrl?: string;
 }
 /**
@@ -24,4 +24,9 @@ export interface BenjiConfig {
  */
 export declare function configure(options: BenjiConfig): void;
 export { client };
+export { BenjiError, BenjiConfigError, BenjiApiError } from "./errors.js";
+export { initializeFromEnv } from "./env.js";
+export { callSdkMethod, listSdkMethods } from "./methods.js";
+export type { SdkMethodDescriptor, SdkMethodOptions } from "./methods.js";
+export { wrapSdkCall } from "./wrapper.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,QAO7C;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,QAO7C;AAED,OAAO,EAAE,MAAM,EAAE,CAAC;AAGlB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 // Re-export everything from generated client
-export * from "./client";
+export * from "./client/index.js";
 // Import client config
-import { client } from "./client/client.gen";
+import { client } from "./client/client.gen.js";
 /**
  * Configure the Benji SDK with your API key
  *
@@ -20,10 +20,15 @@ import { client } from "./client/client.gen";
  */
 export function configure(options) {
     client.setConfig({
-        baseUrl: options.baseUrl ?? "https://app.benji.so/api/rest",
+        baseUrl: options.baseUrl ?? "https://alpha.benji.so/api/rest",
         headers: {
             "x-api-key": options.apiKey,
         },
     });
 }
 export { client };
+// Error types and utilities
+export { BenjiError, BenjiConfigError, BenjiApiError } from "./errors.js";
+export { initializeFromEnv } from "./env.js";
+export { callSdkMethod, listSdkMethods } from "./methods.js";
+export { wrapSdkCall } from "./wrapper.js";

package/dist/method-metadata.gen.d.ts

@@ -0,0 +1,2 @@
+export declare const methodMetadata: {};
+//# sourceMappingURL=method-metadata.gen.d.ts.map

package/dist/method-metadata.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-metadata.gen.d.ts","sourceRoot":"","sources":["../src/method-metadata.gen.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,IAAK,CAAC"}

package/dist/method-metadata.gen.js

@@ -0,0 +1,2 @@
+// This file is auto-generated by generate-method-metadata.mjs
+export const methodMetadata = {};

package/dist/methods.d.ts

@@ -0,0 +1,27 @@
+export interface SdkMethodOptions {
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    [key: string]: unknown;
+}
+export interface SdkMethodDescriptor {
+    namespace: string;
+    method: string;
+    fullName: string;
+    resource: string;
+    action: string;
+    toolName: string;
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    httpMethod?: string;
+    path?: string;
+    exampleInput?: Record<string, unknown>;
+}
+export declare function listSdkMethods(filters?: {
+    namespace?: string;
+    search?: string;
+}): SdkMethodDescriptor[];
+export declare function callSdkMethod<T = unknown>(methodName: string, options?: SdkMethodOptions): Promise<T>;
+//# sourceMappingURL=methods.d.ts.map

package/dist/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAkKD,wBAAgB,cAAc,CAAC,OAAO,GAAE;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,mBAAmB,EAAE,CAqB7B;AAED,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAC7C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,CAwBZ"}

package/dist/methods.js

@@ -0,0 +1,147 @@
+import * as generatedClient from "./client/index.js";
+import { BenjiApiError } from "./errors.js";
+import { methodMetadata } from "./method-metadata.gen.js";
+import { wrapSdkCall } from "./wrapper.js";
+const RESERVED_STATIC_PROPERTIES = new Set(["length", "name", "prototype"]);
+const generatedMethodMetadata = methodMetadata;
+let cachedDescriptors;
+let cachedRegistry;
+function toKebabCase(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
+        .replace(/[_\s]+/g, "-")
+        .toLowerCase();
+}
+function toSnakeCase(value) {
+    return toKebabCase(value).replace(/-/g, "_");
+}
+function getCommonPrefix(values) {
+    if (values.length === 0) {
+        return "";
+    }
+    let prefix = values[0] ?? "";
+    for (const value of values.slice(1)) {
+        let index = 0;
+        while (index < prefix.length &&
+            index < value.length &&
+            prefix[index] === value[index]) {
+            index += 1;
+        }
+        prefix = prefix.slice(0, index);
+        if (!prefix) {
+            break;
+        }
+    }
+    return prefix;
+}
+function buildRegistry() {
+    const rawDescriptors = [];
+    const registry = new Map();
+    for (const [namespace, exportedValue] of Object.entries(generatedClient)) {
+        if (typeof exportedValue !== "function") {
+            continue;
+        }
+        const exportedRecord = exportedValue;
+        const staticMethods = Object.getOwnPropertyNames(exportedValue)
+            .filter((method) => !RESERVED_STATIC_PROPERTIES.has(method))
+            .filter((method) => typeof exportedRecord[method] === "function")
+            .sort();
+        if (staticMethods.length === 0) {
+            continue;
+        }
+        for (const method of staticMethods) {
+            const fullName = `${namespace}.${method}`;
+            const methodFn = exportedRecord[method];
+            registry.set(fullName, methodFn.bind(exportedValue));
+            rawDescriptors.push({ namespace, method, fullName });
+        }
+    }
+    const methodsByNamespace = new Map();
+    for (const descriptor of rawDescriptors) {
+        const methods = methodsByNamespace.get(descriptor.namespace) ?? [];
+        methods.push(descriptor.method);
+        methodsByNamespace.set(descriptor.namespace, methods);
+    }
+    const descriptors = rawDescriptors.map((descriptor) => {
+        const methods = methodsByNamespace.get(descriptor.namespace) ?? [];
+        const commonPrefix = getCommonPrefix(methods);
+        const resource = toKebabCase(descriptor.namespace);
+        const rawAction = descriptor.method.slice(commonPrefix.length) || descriptor.method;
+        const action = toKebabCase(rawAction);
+        return {
+            ...descriptor,
+            resource,
+            action,
+            toolName: `${toSnakeCase(resource)}_${toSnakeCase(action)}`,
+            ...(generatedMethodMetadata[descriptor.fullName] ?? {}),
+        };
+    });
+    descriptors.sort((left, right) => left.fullName.localeCompare(right.fullName));
+    return { descriptors, registry };
+}
+function ensureRegistry() {
+    if (cachedDescriptors && cachedRegistry) {
+        return;
+    }
+    const { descriptors, registry } = buildRegistry();
+    cachedDescriptors = descriptors;
+    cachedRegistry = registry;
+}
+function getDescriptors() {
+    ensureRegistry();
+    return cachedDescriptors ?? [];
+}
+function getRegistry() {
+    ensureRegistry();
+    return cachedRegistry ?? new Map();
+}
+function resolveMethodName(methodName) {
+    const registry = getRegistry();
+    if (registry.has(methodName)) {
+        return methodName;
+    }
+    const normalized = methodName.toLowerCase();
+    const descriptor = getDescriptors().find((entry) => entry.fullName.toLowerCase() === normalized);
+    if (descriptor) {
+        return descriptor.fullName;
+    }
+    throw new Error(`Unknown SDK method "${methodName}". Use listSdkMethods() to inspect the available generated methods.`);
+}
+export function listSdkMethods(filters = {}) {
+    const namespace = filters.namespace?.trim().toLowerCase();
+    const search = filters.search?.trim().toLowerCase();
+    return getDescriptors().filter((entry) => {
+        if (namespace && entry.namespace.toLowerCase() !== namespace) {
+            return false;
+        }
+        if (search &&
+            !entry.fullName.toLowerCase().includes(search) &&
+            !entry.method.toLowerCase().includes(search) &&
+            !entry.summary?.toLowerCase().includes(search) &&
+            !entry.description?.toLowerCase().includes(search)) {
+            return false;
+        }
+        return true;
+    });
+}
+export async function callSdkMethod(methodName, options = {}) {
+    const resolvedMethodName = resolveMethodName(methodName);
+    const method = getRegistry().get(resolvedMethodName);
+    if (!method) {
+        throw new Error(`SDK method "${resolvedMethodName}" is unavailable.`);
+    }
+    try {
+        const promise = method(options);
+        return await wrapSdkCall(promise);
+    }
+    catch (error) {
+        if (error instanceof BenjiApiError) {
+            throw error;
+        }
+        if (error instanceof Error) {
+            throw new Error(`Failed to call "${resolvedMethodName}": ${error.message}`);
+        }
+        throw error;
+    }
+}

package/dist/wrapper.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Wraps an SDK call and normalizes errors into BenjiApiError.
+ *
+ * The @hey-api/openapi-ts client returns { data, error, response } in non-throw mode.
+ * This function extracts data on success or throws a BenjiApiError on failure.
+ * Network-level errors (DNS failure, connection refused, timeout) are also
+ * caught and wrapped as BenjiApiError with status 0.
+ *
+ * @example
+ * ```ts
+ * const todos = await wrapSdkCall(Todos.todosList({ body: { screen: "today" } }));
+ * // todos is the data, or throws BenjiApiError
+ * ```
+ */
+export declare function wrapSdkCall<T>(promise: Promise<{
+    data?: T;
+    error?: unknown;
+    response: Response;
+}>): Promise<T>;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC,GAClE,OAAO,CAAC,CAAC,CAAC,CAoCZ"}

package/dist/wrapper.js

@@ -0,0 +1,49 @@
+import { BenjiApiError } from "./errors.js";
+/**
+ * Wraps an SDK call and normalizes errors into BenjiApiError.
+ *
+ * The @hey-api/openapi-ts client returns { data, error, response } in non-throw mode.
+ * This function extracts data on success or throws a BenjiApiError on failure.
+ * Network-level errors (DNS failure, connection refused, timeout) are also
+ * caught and wrapped as BenjiApiError with status 0.
+ *
+ * @example
+ * ```ts
+ * const todos = await wrapSdkCall(Todos.todosList({ body: { screen: "today" } }));
+ * // todos is the data, or throws BenjiApiError
+ * ```
+ */
+export async function wrapSdkCall(promise) {
+    let result;
+    try {
+        result = await promise;
+    }
+    catch (networkError) {
+        const message = networkError instanceof Error
+            ? networkError.message
+            : "Network request failed";
+        throw new BenjiApiError({
+            status: 0,
+            code: "NETWORK_ERROR",
+            message,
+        });
+    }
+    if (result.error) {
+        const status = result.response?.status ?? 0;
+        const err = result.error;
+        throw new BenjiApiError({
+            status,
+            code: err.code ?? (status === 0 ? "NETWORK_ERROR" : `HTTP_${status}`),
+            message: err.message ?? (status === 0 ? "Network request failed" : `API request failed with status ${status}`),
+            issues: err.issues,
+        });
+    }
+    if (result.data === undefined) {
+        throw new BenjiApiError({
+            status: result.response.status,
+            code: "EMPTY_RESPONSE",
+            message: "API returned no data and no error",
+        });
+    }
+    return result.data;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "benji-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Official TypeScript SDK for the Benji API - Your personal life operating system",
   "type": "module",
   "main": "./dist/index.js",
@@ -8,8 +8,8 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "files": [
@@ -17,7 +17,10 @@
   ],
   "scripts": {
     "generate": "openapi-ts",
-    "build": "pnpm generate && tsc",
+    "generate-metadata": "node generate-method-metadata.mjs",
+    "fix-imports": "node fix-imports.mjs",
+    "build": "pnpm generate && pnpm generate-metadata && pnpm fix-imports && tsc",
+    "clean": "rm -rf dist",
     "prepublishOnly": "pnpm build"
   },
   "keywords": [
@@ -36,7 +39,8 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/kitze/benji-sdk.git"
+    "url": "git+https://github.com/kitze/benji-sdk.git",
+    "directory": "packages/benji-sdk"
   },
   "bugs": {
     "url": "https://github.com/kitze/benji-sdk/issues"
@@ -46,4 +50,4 @@
     "@hey-api/openapi-ts": "0.90.0",
     "typescript": "^5.5.0"
   }
-}
+}