@voyantjs/cloud-sdk 0.1.0

package/README.md

@@ -0,0 +1,73 @@
+# `@voyantjs/cloud-sdk`
+
+Public TypeScript client for Voyant Cloud APIs.
+
+## Scope
+
+`@voyantjs/cloud-sdk` is for hosted Voyant Cloud services:
+
+- vault (read secrets)
+- sms (send messages, list phone numbers and messages)
+- verification (start verification, check codes, list recent attempts)
+- email (list, send, and fetch email messages)
+
+## Install
+
+```sh
+pnpm add @voyantjs/cloud-sdk
+```
+
+## Usage
+
+```ts
+import { createVoyantCloudClient } from "@voyantjs/cloud-sdk";
+
+const client = createVoyantCloudClient({
+  apiKey: process.env.VOYANT_API_KEY!,
+});
+
+const vaults = await client.vault.listVaults();
+const phoneNumbers = await client.sms.listPhoneNumbers();
+```
+
+## Shape
+
+Root groups:
+
+- `vault`
+- `sms`
+- `verification`
+- `email`
+
+The `vault` group covers list-vaults, list-secrets, and get-secret routes.
+
+The `sms` group covers list-phone-numbers, list-messages, and send-message
+routes.
+
+The `verification` group covers verification start, check, and list-attempts routes.
+
+The `email` group covers list-messages, send-message, and get-message routes.
+
+## Key public types
+
+Useful exported types include:
+
+- `VaultSummary`, `VaultSecretSummary`, `VaultSecretValue`
+- `PhoneNumberSummary`, `SmsMessageSummary`, `SendSmsInput`
+- `VerificationAttemptSummary`, `VerificationCheckResult`
+- `StartVerificationInput`, `CheckVerificationInput`
+- `EmailMessageSummary`, `SendEmailInput`
+- `PhoneNumberStatus`, `SmsMessageStatus`, `VerificationChannel`,
+  `VerificationAttemptStatus`, `EmailMessageStatus`
+
+## Notes
+
+- default base URL is `https://api.voyantjs.com`
+- request auth defaults to `authorization: Bearer <apiKey>`
+- response envelopes of the form `{ data: ... }` are unwrapped by default
+- API tokens are scoped (`vault:read`, `sms:read`, `sms:send`,
+  `phone-numbers:read`, `verification:start`, `verification:check`,
+  `verification:read`, `emails:read`, `emails:send`); requests fail with `403`
+  if the token does not include the required scope
+
+For repo-level context, see [../../docs/cloud.md](../../docs/cloud.md).

package/dist/client.d.ts

@@ -0,0 +1,28 @@
+import { VoyantTransport } from "@voyant-sdk/sdk-core";
+import type { CheckVerificationInput, EmailMessageSummary, PhoneNumberSummary, SendEmailInput, SendSmsInput, SmsMessageSummary, StartVerificationInput, VaultSecretSummary, VaultSecretValue, VaultSummary, VerificationAttemptSummary, VerificationCheckResult, VoyantCloudClientOptions } from "./types.js";
+export declare class VoyantCloudClient {
+    readonly transport: VoyantTransport;
+    constructor(options: VoyantCloudClientOptions);
+    readonly vault: {
+        getSecret: (vaultSlug: string, key: string) => Promise<VaultSecretValue>;
+        listSecrets: (vaultSlug: string) => Promise<VaultSecretSummary[]>;
+        listVaults: () => Promise<VaultSummary[]>;
+    };
+    readonly sms: {
+        listMessages: () => Promise<SmsMessageSummary[]>;
+        listPhoneNumbers: () => Promise<PhoneNumberSummary[]>;
+        sendMessage: (input: SendSmsInput) => Promise<SmsMessageSummary>;
+    };
+    readonly verification: {
+        check: (input: CheckVerificationInput) => Promise<VerificationCheckResult>;
+        listAttempts: () => Promise<VerificationAttemptSummary[]>;
+        start: (input: StartVerificationInput) => Promise<VerificationAttemptSummary>;
+    };
+    readonly email: {
+        getMessage: (id: string) => Promise<EmailMessageSummary>;
+        listMessages: () => Promise<EmailMessageSummary[]>;
+        sendMessage: (input: SendEmailInput) => Promise<EmailMessageSummary>;
+    };
+}
+export declare function createVoyantCloudClient(options: VoyantCloudClientOptions): VoyantCloudClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;gBAExB,OAAO,EAAE,wBAAwB;IAI7C,QAAQ,CAAC,KAAK;+BACW,MAAM,OAAO,MAAM;iCAIjB,MAAM;;MAK/B;IAEF,QAAQ,CAAC,GAAG;;;6BAKW,YAAY;MAKjC;IAEF,QAAQ,CAAC,YAAY;uBACJ,sBAAsB;;uBAStB,sBAAsB;MAKrC;IAEF,QAAQ,CAAC,KAAK;yBACK,MAAM;;6BAIF,cAAc;MAKnC;CACH;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,qBAExE"}

package/dist/client.js

@@ -0,0 +1,42 @@
+import { VoyantTransport } from "@voyant-sdk/sdk-core";
+export class VoyantCloudClient {
+    transport;
+    constructor(options) {
+        this.transport = new VoyantTransport(options);
+    }
+    vault = {
+        getSecret: (vaultSlug, key) => this.transport.request(`/vault/v1/${vaultSlug}/secrets/${key}`),
+        listSecrets: (vaultSlug) => this.transport.request(`/vault/v1/${vaultSlug}/secrets`),
+        listVaults: () => this.transport.request("/vault/v1"),
+    };
+    sms = {
+        listMessages: () => this.transport.request("/sms/v1/messages"),
+        listPhoneNumbers: () => this.transport.request("/sms/v1/phone-numbers"),
+        sendMessage: (input) => this.transport.request("/sms/v1/messages", {
+            body: input,
+            method: "POST",
+        }),
+    };
+    verification = {
+        check: (input) => this.transport.request("/verify/v1/check", {
+            body: input,
+            method: "POST",
+        }),
+        listAttempts: () => this.transport.request("/verify/v1/attempts"),
+        start: (input) => this.transport.request("/verify/v1/start", {
+            body: input,
+            method: "POST",
+        }),
+    };
+    email = {
+        getMessage: (id) => this.transport.request(`/email/v1/messages/${id}`),
+        listMessages: () => this.transport.request("/email/v1/messages"),
+        sendMessage: (input) => this.transport.request("/email/v1/messages", {
+            body: input,
+            method: "POST",
+        }),
+    };
+}
+export function createVoyantCloudClient(options) {
+    return new VoyantCloudClient(options);
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createVoyantCloudClient, VoyantCloudClient } from "./client.js";
+export type { CheckVerificationInput, EmailMessageStatus, EmailMessageSummary, PhoneNumberCapabilities, PhoneNumberStatus, PhoneNumberSummary, SendEmailInput, SendSmsInput, SmsMessageStatus, SmsMessageSummary, StartVerificationInput, VaultSecretSummary, VaultSecretValue, VaultSummary, VerificationAttemptStatus, VerificationAttemptSummary, VerificationChannel, VerificationCheckResult, VoyantCloudClientOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { createVoyantCloudClient, VoyantCloudClient } from "./client.js";

package/dist/types.d.ts

@@ -0,0 +1,129 @@
+import type { VoyantTransportOptions } from "@voyant-sdk/sdk-core";
+export type VoyantCloudClientOptions = VoyantTransportOptions;
+export type PhoneNumberStatus = "active" | "suspended" | "released";
+export type SmsMessageStatus = "queued" | "sent" | "delivered" | "undelivered" | "failed";
+export type VerificationChannel = "sms" | "call" | "email" | "whatsapp";
+export type VerificationAttemptStatus = "pending" | "approved" | "canceled" | "expired" | "failed";
+export type EmailMessageStatus = "queued" | "sent" | "delivered" | "delivery_delayed" | "bounced" | "complained" | "opened" | "clicked" | "failed";
+export interface PhoneNumberCapabilities {
+    mms?: boolean;
+    sms?: boolean;
+    voice?: boolean;
+}
+export interface VaultSummary {
+    createdAt: string;
+    description: string | null;
+    id: string;
+    name: string;
+    secretCount: number;
+    slug: string;
+    updatedAt: string;
+}
+export interface VaultSecretSummary {
+    createdAt: string;
+    key: string;
+    updatedAt: string;
+    version: number;
+}
+export interface VaultSecretValue {
+    key: string;
+    updatedAt: string;
+    value: string;
+    version: number;
+}
+export interface PhoneNumberSummary {
+    capabilities: PhoneNumberCapabilities;
+    country: string;
+    createdAt: string;
+    friendlyName: string | null;
+    id: string;
+    isShared: boolean;
+    monthlyCostCents: number | null;
+    organizationId: string;
+    phoneNumber: string;
+    purchasedAt: string | null;
+    releasedAt: string | null;
+    status: PhoneNumberStatus;
+    updatedAt: string;
+}
+export interface SmsMessageSummary {
+    body: string;
+    createdAt: string;
+    deliveredAt: string | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    fromNumber: string;
+    id: string;
+    lastEventAt: string | null;
+    organizationId: string;
+    priceCents: number | null;
+    providerMessageSid: string | null;
+    providerStatus: string | null;
+    segments: number;
+    sentAt: string | null;
+    status: SmsMessageStatus;
+    toNumber: string;
+    updatedAt: string;
+}
+export interface SendSmsInput {
+    body: string;
+    from?: string | null;
+    to: string;
+}
+export interface VerificationAttemptSummary {
+    channel: VerificationChannel;
+    createdAt: string;
+    errorMessage: string | null;
+    id: string;
+    organizationId: string;
+    providerStatus: string | null;
+    serviceId: string;
+    status: VerificationAttemptStatus;
+    toValue: string;
+    updatedAt: string;
+    verifiedAt: string | null;
+}
+export interface VerificationCheckResult extends VerificationAttemptSummary {
+    valid: boolean;
+}
+export interface StartVerificationInput {
+    channel?: VerificationChannel;
+    locale?: string;
+    to: string;
+}
+export interface CheckVerificationInput {
+    code: string;
+    to: string;
+}
+export interface EmailMessageSummary {
+    bccAddresses: string[];
+    ccAddresses: string[];
+    clickCount: number;
+    createdAt: string;
+    deliveredAt: string | null;
+    errorMessage: string | null;
+    fromAddress: string;
+    id: string;
+    lastEventAt: string | null;
+    openCount: number;
+    organizationId: string;
+    providerStatus: string | null;
+    replyTo: string[];
+    resendEmailId: string | null;
+    sentAt: string | null;
+    status: EmailMessageStatus;
+    subject: string;
+    toAddresses: string[];
+    updatedAt: string;
+}
+export interface SendEmailInput {
+    bcc?: string[] | null;
+    cc?: string[] | null;
+    from: string;
+    html?: string | null;
+    replyTo?: string[] | null;
+    subject: string;
+    text?: string | null;
+    to: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@voyant-sdk/sdk-core/README.md

@@ -0,0 +1,31 @@
+# `@voyant-sdk/sdk-core`
+
+Private shared runtime for the public Voyant SDK packages.
+
+## Purpose
+
+This package centralizes:
+
+- request transport
+- auth header handling
+- query serialization
+- JSON encoding
+- API error handling
+
+It is bundled into `@voyantjs/cloud-sdk` so consumers do not need to install it
+directly.
+
+## Rules
+
+- keep this package private
+- keep it transport-focused
+- do not move product-specific business logic here
+
+## Current exports
+
+- `VoyantTransport`
+- `VoyantApiError`
+- transport option and request option types
+
+If this package starts accumulating product-specific types, the boundary is
+wrong and should be corrected.

package/node_modules/@voyant-sdk/sdk-core/dist/client.d.ts

@@ -0,0 +1,13 @@
+import type { VoyantRequestOptions, VoyantTransportOptions } from "./types.js";
+export declare class VoyantTransport {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    private readonly authHeader;
+    private readonly authScheme;
+    private readonly defaultHeaders;
+    private readonly fetchImpl;
+    private readonly userAgent;
+    constructor(options: VoyantTransportOptions);
+    request<T>(path: string, options?: VoyantRequestOptions): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/node_modules/@voyant-sdk/sdk-core/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AA8E5F,qBAAa,eAAe;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,sBAAsB;IAUrC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB;CA0DlE"}

package/node_modules/@voyant-sdk/sdk-core/dist/client.js

@@ -0,0 +1,122 @@
+import { VoyantApiError } from "./errors.js";
+const DEFAULT_BASE_URL = "https://api.voyantjs.com";
+function appendQuery(url, query) {
+    if (!query) {
+        return;
+    }
+    for (const [key, rawValue] of Object.entries(query)) {
+        if (rawValue === undefined || rawValue === null) {
+            continue;
+        }
+        const values = Array.isArray(rawValue) ? rawValue : [rawValue];
+        for (const value of values) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            url.searchParams.append(key, String(value));
+        }
+    }
+}
+function normalizePath(path) {
+    return path.startsWith("/") ? path : `/${path}`;
+}
+function isBodyInit(value) {
+    return (value instanceof ArrayBuffer ||
+        value instanceof Blob ||
+        value instanceof FormData ||
+        value instanceof ReadableStream ||
+        value instanceof URLSearchParams ||
+        typeof value === "string");
+}
+function maybeJson(text, contentType) {
+    if (!text) {
+        return null;
+    }
+    if (contentType?.includes("application/json")) {
+        return JSON.parse(text);
+    }
+    if (text.startsWith("{") || text.startsWith("[")) {
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    return text;
+}
+function getErrorMessage(body, fallback) {
+    if (typeof body === "string" && body.length > 0) {
+        return body;
+    }
+    if (body &&
+        typeof body === "object" &&
+        "message" in body &&
+        typeof body.message === "string" &&
+        body.message.length > 0) {
+        return body.message;
+    }
+    return fallback;
+}
+export class VoyantTransport {
+    baseUrl;
+    apiKey;
+    authHeader;
+    authScheme;
+    defaultHeaders;
+    fetchImpl;
+    userAgent;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.defaultHeaders = options.headers;
+        this.fetchImpl = options.fetch ?? fetch;
+        this.authHeader = options.authHeader ?? "authorization";
+        this.authScheme = options.authScheme === undefined ? "Bearer" : options.authScheme;
+        this.userAgent = options.userAgent ?? "voyant-sdk";
+    }
+    async request(path, options = {}) {
+        const url = new URL(normalizePath(path), this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`);
+        appendQuery(url, options.query);
+        const headers = new Headers(this.defaultHeaders);
+        headers.set(this.authHeader, this.authScheme ? `${this.authScheme} ${this.apiKey}` : this.apiKey);
+        headers.set("x-voyant-sdk", this.userAgent);
+        if (options.headers) {
+            new Headers(options.headers).forEach((value, key) => {
+                headers.set(key, value);
+            });
+        }
+        let body;
+        if (options.body != null) {
+            if (isBodyInit(options.body)) {
+                body = options.body;
+            }
+            else {
+                headers.set("content-type", "application/json");
+                body = JSON.stringify(options.body);
+            }
+        }
+        const response = await this.fetchImpl(url, {
+            body,
+            headers,
+            method: options.method ?? "GET",
+            signal: options.signal,
+        });
+        const text = await response.text();
+        const parsed = maybeJson(text, response.headers.get("content-type"));
+        if (!response.ok) {
+            throw new VoyantApiError(getErrorMessage(parsed, `Request failed with status ${response.status}`), {
+                body: parsed,
+                requestId: response.headers.get("x-request-id"),
+                status: response.status,
+            });
+        }
+        if (options.unwrapData === false) {
+            return parsed;
+        }
+        if (parsed && typeof parsed === "object" && "data" in parsed) {
+            return parsed.data;
+        }
+        return parsed;
+    }
+}

package/node_modules/@voyant-sdk/sdk-core/dist/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class VoyantApiError extends Error {
+    readonly body: unknown;
+    readonly requestId: string | null;
+    readonly status: number;
+    constructor(message: string, options: {
+        body: unknown;
+        requestId: string | null;
+        status: number;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/node_modules/@voyant-sdk/sdk-core/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAOlG"}

package/node_modules/@voyant-sdk/sdk-core/dist/errors.js

@@ -0,0 +1,12 @@
+export class VoyantApiError extends Error {
+    body;
+    requestId;
+    status;
+    constructor(message, options) {
+        super(message);
+        this.name = "VoyantApiError";
+        this.status = options.status;
+        this.requestId = options.requestId;
+        this.body = options.body;
+    }
+}

package/node_modules/@voyant-sdk/sdk-core/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { VoyantTransport } from "./client.js";
+export { VoyantApiError } from "./errors.js";
+export type { FetchLike, JsonObject, JsonPrimitive, JsonValue, QueryParams, QueryValue, VoyantRequestOptions, VoyantTransportOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@voyant-sdk/sdk-core/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,SAAS,EACT,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/node_modules/@voyant-sdk/sdk-core/dist/index.js

@@ -0,0 +1,2 @@
+export { VoyantTransport } from "./client.js";
+export { VoyantApiError } from "./errors.js";

package/node_modules/@voyant-sdk/sdk-core/dist/types.d.ts

@@ -0,0 +1,26 @@
+export type FetchLike = typeof fetch;
+export type JsonPrimitive = boolean | null | number | string;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type QueryValue = string | number | boolean | null | undefined | Array<string | number | boolean | null | undefined>;
+export type QueryParams = Record<string, QueryValue>;
+export interface VoyantTransportOptions {
+    apiKey: string;
+    authHeader?: string;
+    authScheme?: string | null;
+    baseUrl?: string;
+    fetch?: FetchLike;
+    headers?: HeadersInit;
+    userAgent?: string;
+}
+export interface VoyantRequestOptions {
+    body?: BodyInit | object | null;
+    headers?: HeadersInit;
+    method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    query?: QueryParams;
+    signal?: AbortSignal;
+    unwrapData?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@voyant-sdk/sdk-core/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACrD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/node_modules/@voyant-sdk/sdk-core/dist/types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@voyant-sdk/sdk-core/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@voyant-sdk/sdk-core",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Private shared runtime for Voyant SDK packages.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./src/index.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "eslint src --max-warnings 0",
+    "check-types": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@voyant-sdk/eslint-config": "workspace:*",
+    "@voyant-sdk/typescript-config": "workspace:*",
+    "eslint": "^9.39.1",
+    "typescript": "5.9.2"
+  },
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@voyantjs/cloud-sdk",
+  "version": "0.1.0",
+  "description": "Public TypeScript SDK for Voyant Cloud APIs.",
+  "license": "FSL-1.1-Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyantjs/cloud-sdk.git",
+    "directory": "packages/cloud-sdk"
+  },
+  "homepage": "https://github.com/voyantjs/cloud-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/voyantjs/cloud-sdk/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./src/index.ts",
+  "sideEffects": false,
+  "keywords": [
+    "voyant",
+    "voyant-cloud",
+    "sdk",
+    "typescript"
+  ],
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "bundleDependencies": [
+    "@voyant-sdk/sdk-core"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "eslint src --max-warnings 0",
+    "check-types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@voyant-sdk/sdk-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@voyant-sdk/eslint-config": "workspace:*",
+    "@voyant-sdk/typescript-config": "workspace:*",
+    "eslint": "^9.39.1",
+    "typescript": "5.9.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    }
+  }
+}