@lifestreamdynamics/vault-sdk 1.0.0

package/dist/resources/shares.d.ts

@@ -0,0 +1,130 @@
+import type { KyInstance } from 'ky';
+/** A share link for a document. */
+export interface ShareLink {
+    /** Unique share link identifier. */
+    id: string;
+    /** ID of the shared document. */
+    documentId: string;
+    /** ID of the vault containing the document. */
+    vaultId: string;
+    /** ID of the user who created the share link. */
+    createdBy: string;
+    /** First 8 characters of the share token (for identification). */
+    tokenPrefix: string;
+    /** Permission level granted by this link. */
+    permission: 'view' | 'edit';
+    /** ISO 8601 expiration timestamp, or `null` if the link never expires. */
+    expiresAt: string | null;
+    /** Maximum number of views allowed, or `null` for unlimited. */
+    maxViews: number | null;
+    /** Number of times the link has been viewed. */
+    viewCount: number;
+    /** Whether the share link is currently active. */
+    isActive: boolean;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+}
+/** Parameters for creating a new share link. */
+export interface CreateShareLinkParams {
+    /** Permission level: `'view'` (default) or `'edit'`. */
+    permission?: 'view' | 'edit';
+    /** Optional password to protect the share link (min 4, max 128 chars). */
+    password?: string;
+    /** Optional ISO 8601 expiration date. */
+    expiresAt?: string;
+    /** Optional maximum number of views before the link expires. */
+    maxViews?: number;
+}
+/** Response from creating a share link, including the full token (shown only once). */
+export interface CreateShareLinkResponse {
+    /** The created share link metadata. */
+    shareLink: ShareLink;
+    /** The full share token. Only returned at creation time; cannot be retrieved later. */
+    fullToken: string;
+}
+/**
+ * Resource for managing document share links.
+ *
+ * Share links provide token-based access to documents with optional password
+ * protection, expiration dates, and view limits. Links can grant either
+ * read-only (`view`) or read-write (`edit`) access.
+ *
+ * @example
+ * ```typescript
+ * // Create a view-only share link that expires in 7 days
+ * const result = await client.shares.create('vault-id', 'notes/meeting.md', {
+ *   permission: 'view',
+ *   expiresAt: new Date(Date.now() + 7 * 86400000).toISOString(),
+ * });
+ * console.log('Share URL token:', result.fullToken);
+ * ```
+ */
+export declare class SharesResource {
+    private http;
+    constructor(http: KyInstance);
+    /**
+     * Lists all share links for a specific document.
+     *
+     * @param vaultId - The vault ID containing the document
+     * @param documentPath - File path of the document (e.g., `'notes/meeting.md'`)
+     * @returns Array of share link objects for the document
+     * @throws {NotFoundError} If the vault or document does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const links = await client.shares.list('vault-id', 'notes/meeting.md');
+     * for (const link of links) {
+     *   console.log(`${link.tokenPrefix}... (${link.permission}, views: ${link.viewCount})`);
+     * }
+     * ```
+     */
+    list(vaultId: string, documentPath: string): Promise<ShareLink[]>;
+    /**
+     * Creates a new share link for a document.
+     *
+     * The `fullToken` in the response is only returned at creation time and
+     * cannot be retrieved later. Store it securely or share it immediately.
+     *
+     * @param vaultId - The vault ID containing the document
+     * @param documentPath - File path of the document to share
+     * @param params - Optional share link parameters (permission, password, expiry, max views)
+     * @returns The created share link and its full token
+     * @throws {NotFoundError} If the vault or document does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {ValidationError} If the parameters are invalid
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * // Create a password-protected link with a view limit
+     * const result = await client.shares.create('vault-id', 'notes/secret.md', {
+     *   permission: 'view',
+     *   password: 'secure-password',
+     *   maxViews: 10,
+     * });
+     * console.log('Token:', result.fullToken);
+     * ```
+     */
+    create(vaultId: string, documentPath: string, params?: CreateShareLinkParams): Promise<CreateShareLinkResponse>;
+    /**
+     * Revokes (deactivates) a share link.
+     *
+     * Once revoked, the share link can no longer be used to access the document.
+     * This action is irreversible.
+     *
+     * @param vaultId - The vault ID containing the shared document
+     * @param shareId - The unique identifier of the share link to revoke
+     * @throws {NotFoundError} If the share link does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.shares.revoke('vault-id', 'share-link-id');
+     * ```
+     */
+    revoke(vaultId: string, shareId: string): Promise<void>;
+}
+//# sourceMappingURL=shares.d.ts.map

package/dist/resources/shares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shares.d.ts","sourceRoot":"","sources":["../../src/resources/shares.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAGrC,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uFAAuF;AACvF,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,SAAS,EAAE,SAAS,CAAC;IACrB,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAWvE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,qBAA0B,GACjC,OAAO,CAAC,uBAAuB,CAAC;IAUnC;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO9D"}

package/dist/resources/shares.js

@@ -0,0 +1,115 @@
+import { handleError } from '../handle-error.js';
+/**
+ * Resource for managing document share links.
+ *
+ * Share links provide token-based access to documents with optional password
+ * protection, expiration dates, and view limits. Links can grant either
+ * read-only (`view`) or read-write (`edit`) access.
+ *
+ * @example
+ * ```typescript
+ * // Create a view-only share link that expires in 7 days
+ * const result = await client.shares.create('vault-id', 'notes/meeting.md', {
+ *   permission: 'view',
+ *   expiresAt: new Date(Date.now() + 7 * 86400000).toISOString(),
+ * });
+ * console.log('Share URL token:', result.fullToken);
+ * ```
+ */
+export class SharesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Lists all share links for a specific document.
+     *
+     * @param vaultId - The vault ID containing the document
+     * @param documentPath - File path of the document (e.g., `'notes/meeting.md'`)
+     * @returns Array of share link objects for the document
+     * @throws {NotFoundError} If the vault or document does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const links = await client.shares.list('vault-id', 'notes/meeting.md');
+     * for (const link of links) {
+     *   console.log(`${link.tokenPrefix}... (${link.permission}, views: ${link.viewCount})`);
+     * }
+     * ```
+     */
+    async list(vaultId, documentPath) {
+        try {
+            const data = await this.http
+                .get(`vaults/${vaultId}/shares/document/${documentPath}`)
+                .json();
+            return data.shareLinks;
+        }
+        catch (error) {
+            throw await handleError(error, 'Share Links', documentPath);
+        }
+    }
+    /**
+     * Creates a new share link for a document.
+     *
+     * The `fullToken` in the response is only returned at creation time and
+     * cannot be retrieved later. Store it securely or share it immediately.
+     *
+     * @param vaultId - The vault ID containing the document
+     * @param documentPath - File path of the document to share
+     * @param params - Optional share link parameters (permission, password, expiry, max views)
+     * @returns The created share link and its full token
+     * @throws {NotFoundError} If the vault or document does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {ValidationError} If the parameters are invalid
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * // Create a password-protected link with a view limit
+     * const result = await client.shares.create('vault-id', 'notes/secret.md', {
+     *   permission: 'view',
+     *   password: 'secure-password',
+     *   maxViews: 10,
+     * });
+     * console.log('Token:', result.fullToken);
+     * ```
+     */
+    async create(vaultId, documentPath, params = {}) {
+        try {
+            return await this.http
+                .post(`vaults/${vaultId}/shares/document/${documentPath}`, { json: params })
+                .json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Share Link', documentPath);
+        }
+    }
+    /**
+     * Revokes (deactivates) a share link.
+     *
+     * Once revoked, the share link can no longer be used to access the document.
+     * This action is irreversible.
+     *
+     * @param vaultId - The vault ID containing the shared document
+     * @param shareId - The unique identifier of the share link to revoke
+     * @throws {NotFoundError} If the share link does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.shares.revoke('vault-id', 'share-link-id');
+     * ```
+     */
+    async revoke(vaultId, shareId) {
+        try {
+            await this.http.delete(`vaults/${vaultId}/shares/${shareId}`);
+        }
+        catch (error) {
+            throw await handleError(error, 'Share Link', shareId);
+        }
+    }
+}
+//# sourceMappingURL=shares.js.map

package/dist/resources/shares.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shares.js","sourceRoot":"","sources":["../../src/resources/shares.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgDjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,YAAoB;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI;iBACzB,GAAG,CAAC,UAAU,OAAO,oBAAoB,YAAY,EAAE,CAAC;iBACxD,IAAI,EAA+B,CAAC;YACvC,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,YAAoB,EACpB,SAAgC,EAAE;QAElC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI;iBACnB,IAAI,CAAC,UAAU,OAAO,oBAAoB,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;iBAC3E,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe;QAC3C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,OAAO,WAAW,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF"}

package/dist/resources/subscription.d.ts

@@ -0,0 +1,172 @@
+import type { KyInstance } from 'ky';
+/** Subscription details with current usage. */
+export interface Subscription {
+    /** Subscription tier, plan details, and status. */
+    subscription: {
+        tier: string;
+        expiresAt: string | null;
+        isActive: boolean;
+    };
+    /** Current resource usage counts. */
+    usage: {
+        vaultCount: number;
+        totalStorageBytes: number;
+        apiCallsToday: number;
+        aiTokens: number;
+        hookExecutions: number;
+        webhookDeliveries: number;
+    };
+}
+/** A subscription plan definition. */
+export interface Plan {
+    /** Plan tier identifier. */
+    tier: string;
+    /** Human-readable plan name. */
+    name: string;
+    /** Plan resource limits. */
+    limits: Record<string, number>;
+    /** Plan feature flags. */
+    features: Record<string, boolean>;
+}
+/** A checkout session for upgrading subscription. */
+export interface CheckoutSession {
+    /** URL to redirect the user to for payment. */
+    url: string;
+    /** Unique session identifier. */
+    sessionId: string;
+}
+/** A billing portal session. */
+export interface PortalSession {
+    /** URL to redirect the user to for billing management. */
+    url: string;
+}
+/** An invoice record. */
+export interface Invoice {
+    /** Unique invoice identifier. */
+    id: string;
+    /** Invoice amount in smallest currency unit. */
+    amount: number;
+    /** ISO 4217 currency code. */
+    currency: string;
+    /** Invoice status (e.g., `paid`, `open`, `void`). */
+    status: string;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 payment timestamp, or `null` if unpaid. */
+    paidAt: string | null;
+    /** URL to view the invoice, or `null`. */
+    invoiceUrl: string | null;
+}
+/**
+ * Resource for managing subscriptions and billing.
+ *
+ * @example
+ * ```typescript
+ * const sub = await client.subscription.get();
+ * console.log(`Plan: ${sub.subscription.tier}`);
+ *
+ * const plans = await client.subscription.listPlans();
+ * plans.forEach(p => console.log(p.name));
+ * ```
+ */
+export declare class SubscriptionResource {
+    private http;
+    constructor(http: KyInstance);
+    /**
+     * Retrieves the current user's subscription details and usage.
+     *
+     * @returns Subscription object with usage breakdown
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const sub = await client.subscription.get();
+     * console.log(`Plan: ${sub.subscription.tier}, Active: ${sub.subscription.isActive}`);
+     * console.log(`Vaults: ${sub.usage.vaultCount}`);
+     * ```
+     */
+    get(): Promise<Subscription>;
+    /**
+     * Lists all available subscription plans.
+     *
+     * @returns Array of available plans
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const plans = await client.subscription.listPlans();
+     * plans.forEach(p => console.log(`${p.name}: ${JSON.stringify(p.limits)}`));
+     * ```
+     */
+    listPlans(): Promise<Plan[]>;
+    /**
+     * Creates a checkout session for upgrading to a paid plan.
+     *
+     * @param tier - Subscription tier to upgrade to (`pro` or `business`)
+     * @param returnUrl - URL to redirect after checkout completes
+     * @returns Checkout session with redirect URL
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {ValidationError} If the tier is invalid or not an upgrade
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const session = await client.subscription.createCheckoutSession(
+     *   'pro',
+     *   'https://app.example.com/subscription/success'
+     * );
+     * console.log('Redirect to:', session.url);
+     * ```
+     */
+    createCheckoutSession(tier: string, returnUrl: string): Promise<CheckoutSession>;
+    /**
+     * Cancels the current subscription.
+     *
+     * @param reason - Optional cancellation reason
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {ValidationError} If no active subscription exists
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.subscription.cancel('Switching to self-hosted');
+     * ```
+     */
+    cancel(reason?: string): Promise<void>;
+    /**
+     * Creates a billing portal session for managing payment methods and invoices.
+     *
+     * @param returnUrl - URL to redirect after the portal session ends
+     * @returns Portal session with redirect URL
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const portal = await client.subscription.createPortalSession(
+     *   'https://app.example.com/settings/billing'
+     * );
+     * console.log('Redirect to:', portal.url);
+     * ```
+     */
+    createPortalSession(returnUrl: string): Promise<PortalSession>;
+    /**
+     * Lists all invoices for the current user.
+     *
+     * @returns Array of invoice records
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const invoices = await client.subscription.listInvoices();
+     * invoices.forEach(inv => {
+     *   console.log(`${inv.createdAt}: ${inv.amount} ${inv.currency} - ${inv.status}`);
+     * });
+     * ```
+     */
+    listInvoices(): Promise<Invoice[]>;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/resources/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/resources/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAGrC,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,qCAAqC;IACrC,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,IAAI;IACnB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,yBAAyB;AACzB,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;OAaG;IACG,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;IAQlC;;;;;;;;;;;;OAYG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IASlC;;;;;;;;;;;;;;;;;;OAkBG;IACG,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAUtF;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;;;;;;;;;;;;;;OAeG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAUpE;;;;;;;;;;;;;;OAcG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAQzC"}

package/dist/resources/subscription.js

@@ -0,0 +1,166 @@
+import { handleError } from '../handle-error.js';
+/**
+ * Resource for managing subscriptions and billing.
+ *
+ * @example
+ * ```typescript
+ * const sub = await client.subscription.get();
+ * console.log(`Plan: ${sub.subscription.tier}`);
+ *
+ * const plans = await client.subscription.listPlans();
+ * plans.forEach(p => console.log(p.name));
+ * ```
+ */
+export class SubscriptionResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Retrieves the current user's subscription details and usage.
+     *
+     * @returns Subscription object with usage breakdown
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const sub = await client.subscription.get();
+     * console.log(`Plan: ${sub.subscription.tier}, Active: ${sub.subscription.isActive}`);
+     * console.log(`Vaults: ${sub.usage.vaultCount}`);
+     * ```
+     */
+    async get() {
+        try {
+            return await this.http.get('subscription').json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Subscription', '');
+        }
+    }
+    /**
+     * Lists all available subscription plans.
+     *
+     * @returns Array of available plans
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const plans = await client.subscription.listPlans();
+     * plans.forEach(p => console.log(`${p.name}: ${JSON.stringify(p.limits)}`));
+     * ```
+     */
+    async listPlans() {
+        try {
+            const data = await this.http.get('subscription/plans').json();
+            return data.plans;
+        }
+        catch (error) {
+            throw await handleError(error, 'Plans', '');
+        }
+    }
+    /**
+     * Creates a checkout session for upgrading to a paid plan.
+     *
+     * @param tier - Subscription tier to upgrade to (`pro` or `business`)
+     * @param returnUrl - URL to redirect after checkout completes
+     * @returns Checkout session with redirect URL
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {ValidationError} If the tier is invalid or not an upgrade
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const session = await client.subscription.createCheckoutSession(
+     *   'pro',
+     *   'https://app.example.com/subscription/success'
+     * );
+     * console.log('Redirect to:', session.url);
+     * ```
+     */
+    async createCheckoutSession(tier, returnUrl) {
+        try {
+            return await this.http.post('subscription/checkout', {
+                json: { tier, returnUrl },
+            }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Checkout', '');
+        }
+    }
+    /**
+     * Cancels the current subscription.
+     *
+     * @param reason - Optional cancellation reason
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {ValidationError} If no active subscription exists
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.subscription.cancel('Switching to self-hosted');
+     * ```
+     */
+    async cancel(reason) {
+        try {
+            await this.http.post('subscription/cancel', {
+                json: { reason },
+            }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Subscription', '');
+        }
+    }
+    /**
+     * Creates a billing portal session for managing payment methods and invoices.
+     *
+     * @param returnUrl - URL to redirect after the portal session ends
+     * @returns Portal session with redirect URL
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const portal = await client.subscription.createPortalSession(
+     *   'https://app.example.com/settings/billing'
+     * );
+     * console.log('Redirect to:', portal.url);
+     * ```
+     */
+    async createPortalSession(returnUrl) {
+        try {
+            return await this.http.post('subscription/portal', {
+                json: { returnUrl },
+            }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Portal', '');
+        }
+    }
+    /**
+     * Lists all invoices for the current user.
+     *
+     * @returns Array of invoice records
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const invoices = await client.subscription.listInvoices();
+     * invoices.forEach(inv => {
+     *   console.log(`${inv.createdAt}: ${inv.amount} ${inv.currency} - ${inv.status}`);
+     * });
+     * ```
+     */
+    async listInvoices() {
+        try {
+            const data = await this.http.get('subscription/invoices').json();
+            return data.invoices;
+        }
+        catch (error) {
+            throw await handleError(error, 'Invoices', '');
+        }
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/resources/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/resources/subscription.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiEjD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oBAAoB;IACX;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,GAAG;QACP,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,EAAgB,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,IAAI,EAAqB,CAAC;YACjF,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,qBAAqB,CAAC,IAAY,EAAE,SAAiB;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBACnD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAC1B,CAAC,CAAC,IAAI,EAAmB,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,MAAM,CAAC,MAAe;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE;gBAC1C,IAAI,EAAE,EAAE,MAAM,EAAE;aACjB,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,mBAAmB,CAAC,SAAiB;QACzC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE;gBACjD,IAAI,EAAE,EAAE,SAAS,EAAE;aACpB,CAAC,CAAC,IAAI,EAAiB,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,IAAI,EAA2B,CAAC;YAC1F,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF"}