@clonecommand/cloud 0.0.3 → 0.0.7

package/README.md

@@ -4,6 +4,13 @@ The official SDK for CloneCommand managed services.
 
 This library simplifies integration with ephemeral preview environments and provides access to CloneCommand Cloud services like Login Proxy, Storage, and Email.
 
+### 🤖 Agent Ready
+This package is designed to be easily consumed by AI agents and LLMs. It features:
+- **Full TypeScript Definitions**: All methods, arguments, and return types are strictly typed.
+- **Rich JSDoc**: Comprehensive comments and examples to help agents understand the intent behind every function.
+- **Clean API Surface**: A logical, singleton-based structure that is easy to navigate.
+
+
 ## Documentation
 
 Full documentation is available in the [`docs/`](./docs/README.md) directory.

package/dist/email/index.d.ts

@@ -1,69 +1,61 @@
-import { CloneCommandCloud } from '../index.js';
-export interface EmailConfig {
-    id: string;
-    projectId: string;
-    domainId: string;
-    isEnabled: boolean;
-    sesIdentityArn?: string;
-    sesVerificationStatus?: string;
-    dkimTokens?: string;
-}
-export interface InboundEmail {
-    id: string;
-    projectId: string;
-    sender: string;
-    recipient: string;
-    subject: string;
-    snippet: string;
-    bucketPath: string;
-    receivedAt: string;
-    isRead: boolean;
-    hasAttachments: boolean;
-    rawSize: number;
-    threadId?: string;
-    messageId?: string;
-    inReplyTo?: string;
-    references?: string;
-}
-export interface SendEmailOptions {
-    from?: string;
-    to: string | string[];
-    subject: string;
-    html?: string;
-    text?: string;
-}
+import { CloneCommandCloud } from "..";
+import { InboundEmail, SendEmailOptions } from "./types";
+/**
+ * Client for interacting with CloneCommand Email services.
+ */
 export declare class EmailClient {
     private ccc;
     constructor(ccc: CloneCommandCloud);
     /**
-     * Get email configuration for the project.
-     */
-    getConfig(projectId?: string): Promise<EmailConfig | null>;
-    /**
-     * Enable email service for a domain.
+     * Checks if the email service is enabled for the current project.
+     *
+     * @returns A promise resolving to true if enabled, false otherwise.
      */
-    enable(domainId: string, projectId?: string): Promise<EmailConfig>;
+    isEnabled(): Promise<boolean>;
     /**
-     * Send an email.
+     * Sends an email message.
+     *
+     * @param options - The email content and recipient details.
+     * @returns A promise resolving to the Message-ID of the sent email.
+     * @throws Error if sending fails.
+     *
+     * @example
+     * await ccc.email.send({
+     *   to: 'user@example.com',
+     *   subject: 'Hello',
+     *   text: 'This is a test'
+     * });
      */
-    send(options: SendEmailOptions, projectId?: string): Promise<string>;
+    send(options: SendEmailOptions): Promise<string>;
     /**
-     * Get inbound emails.
+     * Retrieves a list of inbound emails received by the project.
+     *
+     * @param options - Filtering and pagination options (limit, before).
+     * @returns A promise resolving to an array of InboundEmail previews.
      */
     getInbound(options?: {
         limit?: number;
         before?: Date;
-    }, projectId?: string): Promise<InboundEmail[]>;
+    }): Promise<InboundEmail[]>;
     /**
-     * Get a specific email by ID.
+     * Retrieves the full details of a specific inbound email, including the body.
+     *
+     * @param emailId - The unique ID of the email.
+     * @returns A promise resolving to the full InboundEmail object, or null if not found.
      */
     get(emailId: string): Promise<InboundEmail | null>;
     /**
-     * Mark an email as read.
+     * Marks an inbound email as read.
+     *
+     * @param emailId - The unique ID of the email.
+     * @returns A promise resolving to true if successful.
      */
     markAsRead(emailId: string): Promise<boolean>;
     /**
-     * Delete an email.
+     * Deletes an inbound email permanently.
+     *
+     * @param emailId - The unique ID of the email.
+     * @returns A promise resolving to true if successful.
      */
     delete(emailId: string): Promise<boolean>;
 }

package/dist/email/index.js

@@ -1,24 +1,24 @@
+/**
+ * Client for interacting with CloneCommand Email services.
+ */
 export class EmailClient {
     ccc;
     constructor(ccc) {
         this.ccc = ccc;
     }
     /**
-     * Get email configuration for the project.
+     * Checks if the email service is enabled for the current project.
+     *
+     * @returns A promise resolving to true if enabled, false otherwise.
      */
-    async getConfig(projectId) {
-        const pid = projectId || this.ccc.projectId;
+    async isEnabled() {
+        const pid = this.ccc.projectId;
         if (!pid)
-            throw new Error("projectId is required");
+            throw new Error("projectId could not be resolved. Ensure CC_PROJECT_TOKEN is set.");
         const query = `
-            query EmailConfig($projectId: ID!) {
+            query EmailStatus($projectId: ID!) {
                 emailConfig(projectId: $projectId) {
-                    id
-                    projectId
-                    domainId
                     isEnabled
-                    sesVerificationStatus
-                    dkimTokens
                 }
             }
         `;
@@ -32,46 +32,26 @@ export class EmailClient {
         });
         if (result.errors)
             throw new Error(result.errors[0].message);
-        return result.data.emailConfig;
-    }
-    /**
-     * Enable email service for a domain.
-     */
-    async enable(domainId, projectId) {
-        const pid = projectId || this.ccc.projectId;
-        if (!pid)
-            throw new Error("projectId is required");
-        const query = `
-            mutation EnableEmail($projectId: ID!, $domainId: ID!) {
-                enableEmail(projectId: $projectId, domainId: $domainId) {
-                    id
-                    projectId
-                    domainId
-                    isEnabled
-                    sesVerificationStatus
-                    dkimTokens
-                }
-            }
-        `;
-        const result = await this.ccc.request('/graphql', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                query,
-                variables: { projectId: pid, domainId }
-            })
-        });
-        if (result.errors)
-            throw new Error(result.errors[0].message);
-        return result.data.enableEmail;
+        return !!result.data.emailConfig?.isEnabled;
     }
     /**
-     * Send an email.
+     * Sends an email message.
+     *
+     * @param options - The email content and recipient details.
+     * @returns A promise resolving to the Message-ID of the sent email.
+     * @throws Error if sending fails.
+     *
+     * @example
+     * await ccc.email.send({
+     *   to: 'user@example.com',
+     *   subject: 'Hello',
+     *   text: 'This is a test'
+     * });
      */
-    async send(options, projectId) {
-        const pid = projectId || this.ccc.projectId;
+    async send(options) {
+        const pid = this.ccc.projectId;
         if (!pid)
-            throw new Error("projectId is required");
+            throw new Error("projectId could not be resolved. Ensure CC_PROJECT_TOKEN is set.");
         const query = `
             mutation SendEmail($projectId: ID!, $email: SendEmailInput!) {
                 sendEmail(projectId: $projectId, email: $email)
@@ -99,12 +79,15 @@ export class EmailClient {
         return result.data.sendEmail;
     }
     /**
-     * Get inbound emails.
+     * Retrieves a list of inbound emails received by the project.
+     *
+     * @param options - Filtering and pagination options (limit, before).
+     * @returns A promise resolving to an array of InboundEmail previews.
      */
-    async getInbound(options = {}, projectId) {
-        const pid = projectId || this.ccc.projectId;
+    async getInbound(options = {}) {
+        const pid = this.ccc.projectId;
         if (!pid)
-            throw new Error("projectId is required");
+            throw new Error("projectId could not be resolved. Ensure CC_PROJECT_TOKEN is set.");
         const query = `
             query InboundEmails($projectId: ID!, $limit: Int, $before: DateTime) {
                 inboundEmails(projectId: $projectId, limit: $limit, before: $before) {
@@ -137,7 +120,10 @@ export class EmailClient {
         return result.data.inboundEmails;
     }
     /**
-     * Get a specific email by ID.
+     * Retrieves the full details of a specific inbound email, including the body.
+     *
+     * @param emailId - The unique ID of the email.
+     * @returns A promise resolving to the full InboundEmail object, or null if not found.
      */
     async get(emailId) {
         const query = `
@@ -169,7 +155,10 @@ export class EmailClient {
         return result.data.email;
     }
     /**
-     * Mark an email as read.
+     * Marks an inbound email as read.
+     *
+     * @param emailId - The unique ID of the email.
+     * @returns A promise resolving to true if successful.
      */
     async markAsRead(emailId) {
         const query = `
@@ -190,7 +179,10 @@ export class EmailClient {
         return result.data.markEmailAsRead;
     }
     /**
-     * Delete an email.
+     * Deletes an inbound email permanently.
+     *
+     * @param emailId - The unique ID of the email.
+     * @returns A promise resolving to true if successful.
      */
     async delete(emailId) {
         const query = `

package/dist/email/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Represents an inbound email received by the system.
+ */
+export interface InboundEmail {
+    /** Unique ID of the email. */
+    id: string;
+    /** Project ID this email belongs to. */
+    projectId: string;
+    /** The email address of the sender. */
+    sender: string;
+    /** The email address of the recipient. */
+    recipient: string;
+    /** The subject line of the email. */
+    subject: string;
+    /** A short snippet/preview of the email content. */
+    snippet: string;
+    /** The full HTML or text body of the email (only available in detailed view). */
+    body?: string;
+    /** The path to the raw email file in storage. */
+    bucketPath: string;
+    /** ISO timestamp when the email was received. */
+    receivedAt: string;
+    /** Whether the email has been marked as read. */
+    isRead: boolean;
+    /** Whether the email contains attachments. */
+    hasAttachments: boolean;
+    /** Total size of the raw email in bytes. */
+    rawSize: number;
+    /** Thread ID for grouping related emails. */
+    threadId?: string;
+    /** Standard Message-ID header. */
+    messageId?: string;
+    /** In-Reply-To header. */
+    inReplyTo?: string;
+    /** References header. */
+    references?: string;
+}
+/**
+ * Options for sending an email.
+ */
+export interface SendEmailOptions {
+    /**
+     * The sender address. Must be a verified domain.
+     * Use "Name <email@domain.com>" or just "email@domain.com".
+     */
+    from?: string;
+    /** The recipient(s). Can be a string or an array of strings. */
+    to: string | string[];
+    /** The subject line. */
+    subject: string;
+    /** The HTML body of the email. */
+    html?: string;
+    /** The plain text body of the email. */
+    text?: string;
+}

package/dist/email/types.js

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

package/dist/index.d.ts

@@ -1,79 +1,100 @@
-export interface CCCConfig {
-    projectId?: string;
-    baseUrl?: string;
-}
-export interface StorageFile {
-    id: string;
-    projectId: string;
-    fileId: string;
-    originalFilename?: string;
-    contentType: string;
-    sizeBytes?: number;
-    extension?: string;
-    publicUrl: string;
-    createdAt: string;
-}
 import { EmailClient } from './email/index.js';
+import { CCCConfig, StorageFile } from './types.js';
+/**
+ * The main client for interacting with CloneCommand managed services.
+ * This class provides access to storage, email, and authentication features.
+ */
 export declare class CloneCommandCloud {
     private config;
+    private _email;
+    /**
+     * Initializes the SDK with configuration options.
+     *
+     * @param config - The configuration object.
+     */
     init(config: CCCConfig): void;
+    /**
+     * Returns the current project ID.
+     * Resolution order:
+     * 1. Manual config via `init()`
+     * 2. `CC_PROJECT_ID` environment variable
+     * 3. Extracted from the `CC_PROJECT_TOKEN` JWT.
+     */
     get projectId(): string | undefined;
+    /**
+     * The base URL for API requests.
+     */
     get baseUrl(): string;
+    /**
+     * The service token used for authentication.
+     * Resolution order:
+     * 1. Manual config via `init()`
+     * 2. `CC_PROJECT_TOKEN` environment variable.
+     */
     get serviceToken(): string | undefined;
     /**
      * Internal helper to make authenticated requests to the CloneCommand API.
-     * This is used by server-side methods (e.g., image uploads).
+     *
+     * @param path - The API path (e.g., '/graphql').
+     * @param options - Standard RequestInit options.
+     * @returns A promise resolving to the JSON response.
+     * @throws Error if the request fails or returns a non-OK status.
+     */
+    request<T = any>(path: string, options?: RequestInit): Promise<T>;
+    /**
+     * Login and authentication utilities.
      */
-    request(path: string, options?: RequestInit): Promise<any>;
     get login(): {
         /**
          * Wraps a standard OAuth authorization URL with the CloneCommand Proxy.
          * This allows ephemeral preview environments (*.clonecommand.app) to handle
          * OAuth redirects without constant provider configuration changes.
          *
-         * @param originalUrl The standard OAuth authorization URL
-         * @returns The proxied URL to redirect the user to
+         * @param originalUrl - The standard OAuth authorization URL.
+         * @returns The proxied URL to redirect the user to.
+         * @throws Error if projectId is not configured.
          */
         proxy: (originalUrl: string) => string;
     };
+    /**
+     * Storage and file management utilities.
+     */
     get storage(): {
         /**
-         * Import a file from a URL and upload it to CloneCommand Storage.
+         * Imports a file from a URL and uploads it to CloneCommand Storage.
          *
-         * @param url The URL of the file to import
-         * @param contentType Optional content type (auto-detected if not provided)
-         * @returns StorageFile object with publicUrl
+         * @param url - The URL of the file to import.
+         * @param contentType - Optional content type (auto-detected if not provided).
+         * @returns A promise resolving to the StorageFile record.
          *
          * @example
          * const file = await ccc.storage.importFileFromUrl('https://example.com/image.png');
-         * console.log(file.publicUrl); // https://media.clonecommand.com/:projectId/:fileId/original.png
          */
         importFileFromUrl: (url: string, contentType?: string) => Promise<StorageFile>;
         /**
-         * Import a file from a Buffer and upload it to CloneCommand Storage.
-         *
-         * @param buffer The file buffer
-         * @param contentType The content type of the file
-         * @returns StorageFile object with publicUrl
+         * Uploads a file from a memory buffer.
          *
-         * @example
-         * const buffer = fs.readFileSync('image.png');
-         * const file = await ccc.storage.importFileFromBuffer(buffer, 'image/png');
+         * @param buffer - The file contents as a Buffer.
+         * @param contentType - The MIME type of the file.
+         * @param filename - Optional filename.
+         * @returns A promise resolving to the StorageFile record.
          */
         importFileFromBuffer: (buffer: Buffer, contentType: string, filename?: string) => Promise<StorageFile>;
         /**
-         * Get the public URL for a file.
-         *
-         * @param fileId The file ID
-         * @param projectSlug Optional project slug (uses projectId from config if not provided)
-         * @returns The public URL
+         * Generates a public URL for a given file ID.
          *
-         * @example
-         * const url = ccc.storage.getFileUrl('abc-123-def', 'my-project');
-         * // => https://my-project.clonecommand.media/abc-123-def/original
+         * @param fileId - The unique file ID.
+         * @param projectSlug - Optional project slug (automatically resolved from projectId if not provided).
+         * @returns The public URL string.
          */
         getFileUrl: (fileId: string, projectSlug?: string) => string;
     };
+    /**
+     * Access to email services.
+     */
     get email(): EmailClient;
 }
+/**
+ * Singleton instance of the CloneCommandCloud client.
+ */
 export declare const ccc: CloneCommandCloud;

package/dist/index.js

@@ -1,12 +1,29 @@
 import { EmailClient } from './email/index.js';
+/**
+ * The main client for interacting with CloneCommand managed services.
+ * This class provides access to storage, email, and authentication features.
+ */
 export class CloneCommandCloud {
     config = {};
+    _email = null;
+    /**
+     * Initializes the SDK with configuration options.
+     *
+     * @param config - The configuration object.
+     */
     init(config) {
         this.config = {
             ...this.config,
             ...config,
         };
     }
+    /**
+     * Returns the current project ID.
+     * Resolution order:
+     * 1. Manual config via `init()`
+     * 2. `CC_PROJECT_ID` environment variable
+     * 3. Extracted from the `CC_PROJECT_TOKEN` JWT.
+     */
     get projectId() {
         if (this.config.projectId)
             return this.config.projectId;
@@ -30,15 +47,28 @@ export class CloneCommandCloud {
         }
         return undefined;
     }
+    /**
+     * The base URL for API requests.
+     */
     get baseUrl() {
         return this.config.baseUrl || 'https://graph.clonecommand.com';
     }
+    /**
+     * The service token used for authentication.
+     * Resolution order:
+     * 1. Manual config via `init()`
+     * 2. `CC_PROJECT_TOKEN` environment variable.
+     */
     get serviceToken() {
-        return typeof process !== 'undefined' ? process.env.CC_PROJECT_TOKEN : undefined;
+        return this.config.serviceToken || (typeof process !== 'undefined' ? process.env.CC_PROJECT_TOKEN : undefined);
     }
     /**
      * Internal helper to make authenticated requests to the CloneCommand API.
-     * This is used by server-side methods (e.g., image uploads).
+     *
+     * @param path - The API path (e.g., '/graphql').
+     * @param options - Standard RequestInit options.
+     * @returns A promise resolving to the JSON response.
+     * @throws Error if the request fails or returns a non-OK status.
      */
     async request(path, options = {}) {
         const token = this.serviceToken;
@@ -56,6 +86,9 @@ export class CloneCommandCloud {
         }
         return response.json();
     }
+    /**
+     * Login and authentication utilities.
+     */
     get login() {
         return {
             /**
@@ -63,43 +96,40 @@ export class CloneCommandCloud {
              * This allows ephemeral preview environments (*.clonecommand.app) to handle
              * OAuth redirects without constant provider configuration changes.
              *
-             * @param originalUrl The standard OAuth authorization URL
-             * @returns The proxied URL to redirect the user to
+             * @param originalUrl - The standard OAuth authorization URL.
+             * @returns The proxied URL to redirect the user to.
+             * @throws Error if projectId is not configured.
              */
             proxy: (originalUrl) => {
                 const pid = this.projectId;
                 if (!pid) {
-                    throw new Error("CloneCommand: projectId is required. Provide it in ccc.init({ projectId }) " +
-                        "or set the CC_PROJECT_ID environment variable.");
+                    throw new Error("CloneCommand: projectId is required but could not be resolved from CC_PROJECT_TOKEN or environment. " +
+                        "Provide it in ccc.init({ projectId }) or set the CC_PROJECT_ID environment variable.");
                 }
                 const encodedUrl = encodeURIComponent(originalUrl);
                 return `${this.baseUrl}/login/proxy/start?projectId=${pid}&url=${encodedUrl}`;
             }
         };
     }
+    /**
+     * Storage and file management utilities.
+     */
     get storage() {
         return {
             /**
-             * Import a file from a URL and upload it to CloneCommand Storage.
+             * Imports a file from a URL and uploads it to CloneCommand Storage.
              *
-             * @param url The URL of the file to import
-             * @param contentType Optional content type (auto-detected if not provided)
-             * @returns StorageFile object with publicUrl
+             * @param url - The URL of the file to import.
+             * @param contentType - Optional content type (auto-detected if not provided).
+             * @returns A promise resolving to the StorageFile record.
              *
              * @example
              * const file = await ccc.storage.importFileFromUrl('https://example.com/image.png');
-             * console.log(file.publicUrl); // https://media.clonecommand.com/:projectId/:fileId/original.png
              */
             importFileFromUrl: async (url, contentType) => {
-                const token = this.serviceToken;
                 const pid = this.projectId;
-                if (!token) {
-                    throw new Error("CloneCommand Storage: CC_PROJECT_TOKEN is required. " +
-                        "Ensure your service is deployed via CloneCommand or use 'clones run' for local development.");
-                }
                 if (!pid) {
-                    throw new Error("CloneCommand Storage: projectId is required. " +
-                        "Set CC_PROJECT_ID environment variable or call ccc.init({ projectId }).");
+                    throw new Error("CloneCommand Storage: projectId could not be resolved. Ensure CC_PROJECT_TOKEN is set.");
                 }
                 const query = `
                     mutation UploadFileFromUrl($projectId: String!, $url: String!, $contentType: String) {
@@ -118,9 +148,7 @@ export class CloneCommandCloud {
                 `;
                 const result = await this.request('/graphql', {
                     method: 'POST',
-                    headers: {
-                        'Content-Type': 'application/json',
-                    },
+                    headers: { 'Content-Type': 'application/json' },
                     body: JSON.stringify({
                         query,
                         variables: { projectId: pid, url, contentType },
@@ -132,24 +160,17 @@ export class CloneCommandCloud {
                 return result.data.uploadFileFromUrl;
             },
             /**
-             * Import a file from a Buffer and upload it to CloneCommand Storage.
+             * Uploads a file from a memory buffer.
              *
-             * @param buffer The file buffer
-             * @param contentType The content type of the file
-             * @returns StorageFile object with publicUrl
-             *
-             * @example
-             * const buffer = fs.readFileSync('image.png');
-             * const file = await ccc.storage.importFileFromBuffer(buffer, 'image/png');
+             * @param buffer - The file contents as a Buffer.
+             * @param contentType - The MIME type of the file.
+             * @param filename - Optional filename.
+             * @returns A promise resolving to the StorageFile record.
              */
             importFileFromBuffer: async (buffer, contentType, filename = 'file') => {
-                const token = this.serviceToken;
                 const pid = this.projectId;
-                if (!token) {
-                    throw new Error("CloneCommand Storage: CC_PROJECT_TOKEN is required.");
-                }
                 if (!pid) {
-                    throw new Error("CloneCommand Storage: projectId is required.");
+                    throw new Error("CloneCommand Storage: projectId could not be resolved. Ensure CC_PROJECT_TOKEN is set.");
                 }
                 const query = `
                     mutation UploadFileFromBuffer($projectId: String!, $buffer: String!, $contentType: String!, $filename: String!) {
@@ -185,31 +206,33 @@ export class CloneCommandCloud {
                 return result.data.uploadFileFromBuffer;
             },
             /**
-             * Get the public URL for a file.
+             * Generates a public URL for a given file ID.
              *
-             * @param fileId The file ID
-             * @param projectSlug Optional project slug (uses projectId from config if not provided)
-             * @returns The public URL
-             *
-             * @example
-             * const url = ccc.storage.getFileUrl('abc-123-def', 'my-project');
-             * // => https://my-project.clonecommand.media/abc-123-def/original
+             * @param fileId - The unique file ID.
+             * @param projectSlug - Optional project slug (automatically resolved from projectId if not provided).
+             * @returns The public URL string.
              */
             getFileUrl: (fileId, projectSlug) => {
                 const pid = this.projectId;
                 const slug = projectSlug || pid;
                 if (!slug) {
-                    throw new Error("CloneCommand Storage: projectId or projectSlug is required. " +
-                        "Set CC_PROJECT_ID environment variable or call ccc.init({ projectId }).");
+                    throw new Error("CloneCommand Storage: projectId or projectSlug could not be resolved.");
                 }
-                // Note: This returns the default projectslug.clonecommand.media URL
-                // Custom domains are handled server-side
                 return `https://${slug}.clonecommand.media/${fileId}/original`;
             },
         };
     }
+    /**
+     * Access to email services.
+     */
     get email() {
-        return new EmailClient(this);
+        if (!this._email) {
+            this._email = new EmailClient(this);
+        }
+        return this._email;
     }
 }
+/**
+ * Singleton instance of the CloneCommandCloud client.
+ */
 export const ccc = new CloneCommandCloud();

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Configuration for the CloneCommand Cloud SDK.
+ */
+export interface CCCConfig {
+    /**
+     * The unique identifier for your project.
+     * Can also be set via the `CC_PROJECT_ID` environment variable.
+     */
+    projectId?: string;
+    /**
+     * The base URL for the CloneCommand API.
+     * Defaults to `https://graph.clonecommand.com`.
+     */
+    baseUrl?: string;
+    /**
+     * The service token for authentication.
+     * Can also be set via the `CC_PROJECT_TOKEN` environment variable.
+     */
+    serviceToken?: string;
+}
+/**
+ * Represents a file stored in CloneCommand Storage.
+ */
+export interface StorageFile {
+    /** Unique ID of the storage record. */
+    id: string;
+    /** Project ID this file belongs to. */
+    projectId: string;
+    /** The underlying storage provider's file ID. */
+    fileId: string;
+    /** Original filename if available. */
+    originalFilename?: string;
+    /** MIME type of the file. */
+    contentType: string;
+    /** Size of the file in bytes. */
+    sizeBytes?: number;
+    /** File extension. */
+    extension?: string;
+    /** Publicly accessible URL for the file. */
+    publicUrl: string;
+    /** ISO timestamp when the file was uploaded. */
+    createdAt: string;
+}

package/dist/types.js

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

package/docs/email.md

@@ -10,17 +10,17 @@ Managed email sending and receiving with inbound processing and domain verificat
 
 ## Usage
 
-### Getting Configuration
+### Checking Status
 
-Check if email is enabled for the current project.
+Check if the email service is enabled and ready to use for the current project.
 
 ```typescript
 import { ccc } from '@clonecommand/cloud';
 
-const config = await ccc.email.getConfig();
+const enabled = await ccc.email.isEnabled();
 
-if (config?.isEnabled) {
-  console.log('Email is active!');
+if (enabled) {
+  console.log('Email is active and ready to send!');
 }
 ```
 

package/package.json

@@ -1,10 +1,20 @@
 {
     "name": "@clonecommand/cloud",
-    "version": "0.0.3",
+    "version": "0.0.7",
     "type": "module",
     "description": "The official SDK for CloneCommand managed services",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./email": {
+            "types": "./dist/email/index.d.ts",
+            "import": "./dist/email/index.js"
+        }
+    },
     "files": [
         "dist",
         "README.md",