@primitivedotdev/sdk 0.26.0 → 0.27.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@primitivedotdev/sdk",
-  "version": "0.26.0",
-  "description": "Official Primitive Node.js SDK: webhook, api, openapi, contract, and parser runtime modules. The CLI moved to @primitivedotdev/cli; this package retains the CLI as a deprecated alias for a few minor releases.",
+  "version": "0.27.0",
+  "description": "Official Primitive Node.js SDK: webhook, api, openapi, contract, and parser runtime modules.",
   "type": "module",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -39,56 +39,8 @@
   },
   "sideEffects": false,
   "files": [
-    "bin",
-    "dist",
-    "oclif.manifest.json"
+    "dist"
   ],
-  "bin": {
-    "primitive": "./bin/run.js"
-  },
-  "oclif": {
-    "bin": "primitive",
-    "commands": {
-      "strategy": "explicit",
-      "target": "./dist/oclif/index.js",
-      "identifier": "COMMANDS"
-    },
-    "dirname": "primitive",
-    "plugins": [
-      "@oclif/plugin-help",
-      "@oclif/plugin-autocomplete"
-    ],
-    "topics": {
-      "cli": {
-        "description": "Browser-assisted CLI authentication"
-      },
-      "account": {
-        "description": "Manage your account settings, storage, and webhook secret"
-      },
-      "domains": {
-        "description": "Claim, verify, and manage email domains"
-      },
-      "emails": {
-        "description": "List, inspect, and manage received emails. Use `primitive emails:latest` for a one-line-per-email summary of recent inbound mail."
-      },
-      "sending": {
-        "description": "Send outbound emails. For replies to inbound mail, use `sending:reply-to-email --id <inbound-id>` (threading and Re: subject derived server-side); for fresh sends, use `sending:send-email` or the `primitive send` shortcut."
-      },
-      "endpoints": {
-        "description": "Manage webhook endpoints that receive email events"
-      },
-      "filters": {
-        "description": "Manage whitelist and blocklist filter rules"
-      },
-      "webhook-deliveries": {
-        "description": "View and replay webhook delivery attempts"
-      },
-      "functions": {
-        "description": "Deploy JavaScript handlers that run on inbound mail. Use `primitive functions:init <name>` to scaffold a deployable project (handler, package.json, build script). Use `primitive functions:deploy --name <name> --file <bundle.js>` to create, `primitive functions:redeploy --id <id> --file <bundle.js>` to push a new bundle, and `primitive functions:set-secret --id <id> --key <KEY> --value <value> [--redeploy]` to write a secret (with optional one-call redeploy so the value lands in the running handler). The auto-generated functions:create-function / functions:update-function / functions:create-function-secret / functions:set-function-secret operations stay available for the full body-string surface."
-      }
-    },
-    "topicSeparator": " "
-  },
   "scripts": {
     "generate:openapi": "tsx scripts/generate-openapi-artifacts.ts",
     "generate:api": "openapi-ts -f openapi-ts.config.ts && tsx scripts/fix-generated-api-imports.ts",
@@ -96,17 +48,13 @@
     "generate:types": "tsx scripts/generate-types.ts",
     "generate:validator": "tsx scripts/generate-validator.ts",
     "generate": "pnpm generate:openapi && pnpm generate:api && pnpm generate:schema && pnpm generate:types && pnpm generate:validator",
-    "build:library": "pnpm generate && tsdown",
-    "build:oclif": "tsc -p tsconfig.oclif.json",
-    "build": "pnpm build:library && pnpm build:oclif",
+    "build": "pnpm generate && tsdown",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "typecheck": "pnpm generate && tsc --noEmit -p tsconfig.typecheck.json",
-    "lint": "biome check --error-on-warnings src/index.ts src/validation.ts src/types.ts src/webhook src/contract src/parser src/api/index.ts src/openapi/index.ts src/oclif tests/",
-    "lint:fix": "biome check --write --error-on-warnings src/index.ts src/validation.ts src/types.ts src/webhook src/contract src/parser src/api/index.ts src/openapi/index.ts src/oclif tests/",
-    "prepack": "pnpm build && oclif manifest",
-    "postpack": "shx rm -f oclif.manifest.json",
+    "lint": "biome check --error-on-warnings src/index.ts src/validation.ts src/types.ts src/webhook src/contract src/parser src/api/index.ts src/openapi/index.ts tests/",
+    "lint:fix": "biome check --write --error-on-warnings src/index.ts src/validation.ts src/types.ts src/webhook src/contract src/parser src/api/index.ts src/openapi/index.ts tests/",
     "prepublishOnly": "pnpm build"
   },
   "keywords": [
@@ -135,9 +83,6 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@oclif/core": "^4.10.5",
-    "@oclif/plugin-autocomplete": "^3.2.45",
-    "@oclif/plugin-help": "^6.2.44",
     "ajv": "^8.17.1",
     "isomorphic-dompurify": "^3.8.0",
     "mailparser": "^3.9.0",
@@ -156,8 +101,6 @@
     "@types/validator": "^13.15.10",
     "@vitest/coverage-v8": "^4.1.4",
     "json-schema-to-typescript": "^15.0.4",
-    "oclif": "^4.23.0",
-    "shx": "^0.3.4",
     "tsdown": "^0.21.10",
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",

package/bin/run.js

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-
-// The CLI moved to @primitivedotdev/cli. This bin is retained on
-// @primitivedotdev/sdk for a few minor versions so existing scripts
-// and agent prompts that invoke `npx @primitivedotdev/sdk@latest
-// <command>` keep working. Every invocation prints a one-line stderr
-// banner with the migration command; the actual oclif runtime runs
-// unchanged after that. The CLI surface will be removed from
-// @primitivedotdev/sdk in a future minor release; until then this
-// shipped snapshot is frozen against the 0.23.0 command set.
-import { execute } from "@oclif/core";
-
-process.stderr.write(
-  "[@primitivedotdev/sdk] Heads up: the CLI moved to @primitivedotdev/cli. " +
-    "Switch to `npx @primitivedotdev/cli@latest <command>` " +
-    "(or `npm install -g @primitivedotdev/cli`). " +
-    "The CLI surface will be removed from @primitivedotdev/sdk in a future minor release.\n",
-);
-
-await execute({ dir: import.meta.url });

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

@@ -1,235 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-import { createSseClient } from '../core/serverSentEvents.gen.js';
-import { getValidRequestBody } from '../core/utils.gen.js';
-import { buildUrl, createConfig, createInterceptors, getParseAs, mergeConfigs, mergeHeaders, setAuthParams, } from './utils.gen.js';
-export const createClient = (config = {}) => {
-    let _config = mergeConfigs(createConfig(), config);
-    const getConfig = () => ({ ..._config });
-    const setConfig = (config) => {
-        _config = mergeConfigs(_config, config);
-        return getConfig();
-    };
-    const interceptors = createInterceptors();
-    const beforeRequest = async (options) => {
-        const opts = {
-            ..._config,
-            ...options,
-            fetch: options.fetch ?? _config.fetch ?? globalThis.fetch,
-            headers: mergeHeaders(_config.headers, options.headers),
-            serializedBody: undefined,
-        };
-        if (opts.security) {
-            await setAuthParams({
-                ...opts,
-                security: opts.security,
-            });
-        }
-        if (opts.requestValidator) {
-            await opts.requestValidator(opts);
-        }
-        if (opts.body !== undefined && opts.bodySerializer) {
-            opts.serializedBody = opts.bodySerializer(opts.body);
-        }
-        // remove Content-Type header if body is empty to avoid sending invalid requests
-        if (opts.body === undefined || opts.serializedBody === '') {
-            opts.headers.delete('Content-Type');
-        }
-        const resolvedOpts = opts;
-        const url = buildUrl(resolvedOpts);
-        return { opts: resolvedOpts, url };
-    };
-    const request = async (options) => {
-        const { opts, url } = await beforeRequest(options);
-        const requestInit = {
-            redirect: 'follow',
-            ...opts,
-            body: getValidRequestBody(opts),
-        };
-        let request = new Request(url, requestInit);
-        for (const fn of interceptors.request.fns) {
-            if (fn) {
-                request = await fn(request, opts);
-            }
-        }
-        // fetch must be assigned here, otherwise it would throw the error:
-        // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation
-        const _fetch = opts.fetch;
-        let response;
-        try {
-            response = await _fetch(request);
-        }
-        catch (error) {
-            // Handle fetch exceptions (AbortError, network errors, etc.)
-            let finalError = error;
-            for (const fn of interceptors.error.fns) {
-                if (fn) {
-                    finalError = (await fn(error, undefined, request, opts));
-                }
-            }
-            finalError = finalError || {};
-            if (opts.throwOnError) {
-                throw finalError;
-            }
-            // Return error response
-            return opts.responseStyle === 'data'
-                ? undefined
-                : {
-                    error: finalError,
-                    request,
-                    response: undefined,
-                };
-        }
-        for (const fn of interceptors.response.fns) {
-            if (fn) {
-                response = await fn(response, request, opts);
-            }
-        }
-        const result = {
-            request,
-            response,
-        };
-        if (response.ok) {
-            const parseAs = (opts.parseAs === 'auto'
-                ? getParseAs(response.headers.get('Content-Type'))
-                : opts.parseAs) ?? 'json';
-            if (response.status === 204 || response.headers.get('Content-Length') === '0') {
-                let emptyData;
-                switch (parseAs) {
-                    case 'arrayBuffer':
-                    case 'blob':
-                    case 'text':
-                        emptyData = await response[parseAs]();
-                        break;
-                    case 'formData':
-                        emptyData = new FormData();
-                        break;
-                    case 'stream':
-                        emptyData = response.body;
-                        break;
-                    case 'json':
-                    default:
-                        emptyData = {};
-                        break;
-                }
-                return opts.responseStyle === 'data'
-                    ? emptyData
-                    : {
-                        data: emptyData,
-                        ...result,
-                    };
-            }
-            let data;
-            switch (parseAs) {
-                case 'arrayBuffer':
-                case 'blob':
-                case 'formData':
-                case 'text':
-                    data = await response[parseAs]();
-                    break;
-                case 'json': {
-                    // Some servers return 200 with no Content-Length and empty body.
-                    // response.json() would throw; read as text and parse if non-empty.
-                    const text = await response.text();
-                    data = text ? JSON.parse(text) : {};
-                    break;
-                }
-                case 'stream':
-                    return opts.responseStyle === 'data'
-                        ? response.body
-                        : {
-                            data: response.body,
-                            ...result,
-                        };
-            }
-            if (parseAs === 'json') {
-                if (opts.responseValidator) {
-                    await opts.responseValidator(data);
-                }
-                if (opts.responseTransformer) {
-                    data = await opts.responseTransformer(data);
-                }
-            }
-            return opts.responseStyle === 'data'
-                ? data
-                : {
-                    data,
-                    ...result,
-                };
-        }
-        const textError = await response.text();
-        let jsonError;
-        try {
-            jsonError = JSON.parse(textError);
-        }
-        catch {
-            // noop
-        }
-        const error = jsonError ?? textError;
-        let finalError = error;
-        for (const fn of interceptors.error.fns) {
-            if (fn) {
-                finalError = (await fn(error, response, request, opts));
-            }
-        }
-        finalError = finalError || {};
-        if (opts.throwOnError) {
-            throw finalError;
-        }
-        // TODO: we probably want to return error and improve types
-        return opts.responseStyle === 'data'
-            ? undefined
-            : {
-                error: finalError,
-                ...result,
-            };
-    };
-    const makeMethodFn = (method) => (options) => request({ ...options, method });
-    const makeSseFn = (method) => async (options) => {
-        const { opts, url } = await beforeRequest(options);
-        return createSseClient({
-            ...opts,
-            body: opts.body,
-            headers: opts.headers,
-            method,
-            onRequest: async (url, init) => {
-                let request = new Request(url, init);
-                for (const fn of interceptors.request.fns) {
-                    if (fn) {
-                        request = await fn(request, opts);
-                    }
-                }
-                return request;
-            },
-            serializedBody: getValidRequestBody(opts),
-            url,
-        });
-    };
-    const _buildUrl = (options) => buildUrl({ ..._config, ...options });
-    return {
-        buildUrl: _buildUrl,
-        connect: makeMethodFn('CONNECT'),
-        delete: makeMethodFn('DELETE'),
-        get: makeMethodFn('GET'),
-        getConfig,
-        head: makeMethodFn('HEAD'),
-        interceptors,
-        options: makeMethodFn('OPTIONS'),
-        patch: makeMethodFn('PATCH'),
-        post: makeMethodFn('POST'),
-        put: makeMethodFn('PUT'),
-        request,
-        setConfig,
-        sse: {
-            connect: makeSseFn('CONNECT'),
-            delete: makeSseFn('DELETE'),
-            get: makeSseFn('GET'),
-            head: makeSseFn('HEAD'),
-            options: makeSseFn('OPTIONS'),
-            patch: makeSseFn('PATCH'),
-            post: makeSseFn('POST'),
-            put: makeSseFn('PUT'),
-            trace: makeSseFn('TRACE'),
-        },
-        trace: makeMethodFn('TRACE'),
-    };
-};

package/dist/api/generated/client/index.js

@@ -1,6 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-export { formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from '../core/bodySerializer.gen.js';
-export { buildClientParams } from '../core/params.gen.js';
-export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen.js';
-export { createClient } from './client.gen.js';
-export { createConfig, mergeHeaders } from './utils.gen.js';

package/dist/api/generated/client/types.gen.js

@@ -1,2 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-export {};

package/dist/api/generated/client/utils.gen.js

@@ -1,228 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-import { getAuthToken } from '../core/auth.gen.js';
-import { jsonBodySerializer } from '../core/bodySerializer.gen.js';
-import { serializeArrayParam, serializeObjectParam, serializePrimitiveParam, } from '../core/pathSerializer.gen.js';
-import { getUrl } from '../core/utils.gen.js';
-export const createQuerySerializer = ({ parameters = {}, ...args } = {}) => {
-    const querySerializer = (queryParams) => {
-        const search = [];
-        if (queryParams && typeof queryParams === 'object') {
-            for (const name in queryParams) {
-                const value = queryParams[name];
-                if (value === undefined || value === null) {
-                    continue;
-                }
-                const options = parameters[name] || args;
-                if (Array.isArray(value)) {
-                    const serializedArray = serializeArrayParam({
-                        allowReserved: options.allowReserved,
-                        explode: true,
-                        name,
-                        style: 'form',
-                        value,
-                        ...options.array,
-                    });
-                    if (serializedArray)
-                        search.push(serializedArray);
-                }
-                else if (typeof value === 'object') {
-                    const serializedObject = serializeObjectParam({
-                        allowReserved: options.allowReserved,
-                        explode: true,
-                        name,
-                        style: 'deepObject',
-                        value: value,
-                        ...options.object,
-                    });
-                    if (serializedObject)
-                        search.push(serializedObject);
-                }
-                else {
-                    const serializedPrimitive = serializePrimitiveParam({
-                        allowReserved: options.allowReserved,
-                        name,
-                        value: value,
-                    });
-                    if (serializedPrimitive)
-                        search.push(serializedPrimitive);
-                }
-            }
-        }
-        return search.join('&');
-    };
-    return querySerializer;
-};
-/**
- * Infers parseAs value from provided Content-Type header.
- */
-export const getParseAs = (contentType) => {
-    if (!contentType) {
-        // If no Content-Type header is provided, the best we can do is return the raw response body,
-        // which is effectively the same as the 'stream' option.
-        return 'stream';
-    }
-    const cleanContent = contentType.split(';')[0]?.trim();
-    if (!cleanContent) {
-        return;
-    }
-    if (cleanContent.startsWith('application/json') || cleanContent.endsWith('+json')) {
-        return 'json';
-    }
-    if (cleanContent === 'multipart/form-data') {
-        return 'formData';
-    }
-    if (['application/', 'audio/', 'image/', 'video/'].some((type) => cleanContent.startsWith(type))) {
-        return 'blob';
-    }
-    if (cleanContent.startsWith('text/')) {
-        return 'text';
-    }
-    return;
-};
-const checkForExistence = (options, name) => {
-    if (!name) {
-        return false;
-    }
-    if (options.headers.has(name) ||
-        options.query?.[name] ||
-        options.headers.get('Cookie')?.includes(`${name}=`)) {
-        return true;
-    }
-    return false;
-};
-export const setAuthParams = async ({ security, ...options }) => {
-    for (const auth of security) {
-        if (checkForExistence(options, auth.name)) {
-            continue;
-        }
-        const token = await getAuthToken(auth, options.auth);
-        if (!token) {
-            continue;
-        }
-        const name = auth.name ?? 'Authorization';
-        switch (auth.in) {
-            case 'query':
-                if (!options.query) {
-                    options.query = {};
-                }
-                options.query[name] = token;
-                break;
-            case 'cookie':
-                options.headers.append('Cookie', `${name}=${token}`);
-                break;
-            case 'header':
-            default:
-                options.headers.set(name, token);
-                break;
-        }
-    }
-};
-export const buildUrl = (options) => getUrl({
-    baseUrl: options.baseUrl,
-    path: options.path,
-    query: options.query,
-    querySerializer: typeof options.querySerializer === 'function'
-        ? options.querySerializer
-        : createQuerySerializer(options.querySerializer),
-    url: options.url,
-});
-export const mergeConfigs = (a, b) => {
-    const config = { ...a, ...b };
-    if (config.baseUrl?.endsWith('/')) {
-        config.baseUrl = config.baseUrl.substring(0, config.baseUrl.length - 1);
-    }
-    config.headers = mergeHeaders(a.headers, b.headers);
-    return config;
-};
-const headersEntries = (headers) => {
-    const entries = [];
-    headers.forEach((value, key) => {
-        entries.push([key, value]);
-    });
-    return entries;
-};
-export const mergeHeaders = (...headers) => {
-    const mergedHeaders = new Headers();
-    for (const header of headers) {
-        if (!header) {
-            continue;
-        }
-        const iterator = header instanceof Headers ? headersEntries(header) : Object.entries(header);
-        for (const [key, value] of iterator) {
-            if (value === null) {
-                mergedHeaders.delete(key);
-            }
-            else if (Array.isArray(value)) {
-                for (const v of value) {
-                    mergedHeaders.append(key, v);
-                }
-            }
-            else if (value !== undefined) {
-                // assume object headers are meant to be JSON stringified, i.e., their
-                // content value in OpenAPI specification is 'application/json'
-                mergedHeaders.set(key, typeof value === 'object' ? JSON.stringify(value) : value);
-            }
-        }
-    }
-    return mergedHeaders;
-};
-class Interceptors {
-    fns = [];
-    clear() {
-        this.fns = [];
-    }
-    eject(id) {
-        const index = this.getInterceptorIndex(id);
-        if (this.fns[index]) {
-            this.fns[index] = null;
-        }
-    }
-    exists(id) {
-        const index = this.getInterceptorIndex(id);
-        return Boolean(this.fns[index]);
-    }
-    getInterceptorIndex(id) {
-        if (typeof id === 'number') {
-            return this.fns[id] ? id : -1;
-        }
-        return this.fns.indexOf(id);
-    }
-    update(id, fn) {
-        const index = this.getInterceptorIndex(id);
-        if (this.fns[index]) {
-            this.fns[index] = fn;
-            return id;
-        }
-        return false;
-    }
-    use(fn) {
-        this.fns.push(fn);
-        return this.fns.length - 1;
-    }
-}
-export const createInterceptors = () => ({
-    error: new Interceptors(),
-    request: new Interceptors(),
-    response: new Interceptors(),
-});
-const defaultQuerySerializer = createQuerySerializer({
-    allowReserved: false,
-    array: {
-        explode: true,
-        style: 'form',
-    },
-    object: {
-        explode: true,
-        style: 'deepObject',
-    },
-});
-const defaultHeaders = {
-    'Content-Type': 'application/json',
-};
-export const createConfig = (override = {}) => ({
-    ...jsonBodySerializer,
-    headers: defaultHeaders,
-    parseAs: 'auto',
-    querySerializer: defaultQuerySerializer,
-    ...override,
-});

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

@@ -1,3 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-import { createClient, createConfig } from './client/index.js';
-export const client = createClient(createConfig({ baseUrl: 'https://www.primitive.dev/api/v1' }));

package/dist/api/generated/core/auth.gen.js

@@ -1,14 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-export const getAuthToken = async (auth, callback) => {
-    const token = typeof callback === 'function' ? await callback(auth) : callback;
-    if (!token) {
-        return;
-    }
-    if (auth.scheme === 'bearer') {
-        return `Bearer ${token}`;
-    }
-    if (auth.scheme === 'basic') {
-        return `Basic ${btoa(token)}`;
-    }
-    return token;
-};

package/dist/api/generated/core/bodySerializer.gen.js

@@ -1,57 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-const serializeFormDataPair = (data, key, value) => {
-    if (typeof value === 'string' || value instanceof Blob) {
-        data.append(key, value);
-    }
-    else if (value instanceof Date) {
-        data.append(key, value.toISOString());
-    }
-    else {
-        data.append(key, JSON.stringify(value));
-    }
-};
-const serializeUrlSearchParamsPair = (data, key, value) => {
-    if (typeof value === 'string') {
-        data.append(key, value);
-    }
-    else {
-        data.append(key, JSON.stringify(value));
-    }
-};
-export const formDataBodySerializer = {
-    bodySerializer: (body) => {
-        const data = new FormData();
-        Object.entries(body).forEach(([key, value]) => {
-            if (value === undefined || value === null) {
-                return;
-            }
-            if (Array.isArray(value)) {
-                value.forEach((v) => serializeFormDataPair(data, key, v));
-            }
-            else {
-                serializeFormDataPair(data, key, value);
-            }
-        });
-        return data;
-    },
-};
-export const jsonBodySerializer = {
-    bodySerializer: (body) => JSON.stringify(body, (_key, value) => (typeof value === 'bigint' ? value.toString() : value)),
-};
-export const urlSearchParamsBodySerializer = {
-    bodySerializer: (body) => {
-        const data = new URLSearchParams();
-        Object.entries(body).forEach(([key, value]) => {
-            if (value === undefined || value === null) {
-                return;
-            }
-            if (Array.isArray(value)) {
-                value.forEach((v) => serializeUrlSearchParamsPair(data, key, v));
-            }
-            else {
-                serializeUrlSearchParamsPair(data, key, value);
-            }
-        });
-        return data.toString();
-    },
-};