@shipstatic/ship 0.3.5 → 0.3.8

package/README.md

@@ -76,7 +76,7 @@ const ship = new Ship({
 
 // Deploy project - SDK automatically fetches platform configuration
 const result = await ship.deployments.create(['./dist'], {
-  onProgress: (progress) => console.log(`${progress}%`)
+  onProgress: ({ percent }) => console.log(`${percent}%`)
 });
 
 console.log(`Deployed: ${result.deployment}`);
@@ -201,6 +201,7 @@ interface ShipOptions {
   apiKey?: string;        // API key: ship- prefix + 64-char hex (69 chars total)
   deployToken?: string;   // Deploy token: token- prefix + 64-char hex (70 chars total)
   timeout?: number;       // Request timeout (ms)
+  useCredentials?: boolean; // Use HTTP-only cookies for auth (skips token check)
 }
 ```
 
@@ -259,8 +260,7 @@ interface DeployOptions {
   signal?: AbortSignal;             // Cancellation
   subdomain?: string;               // Custom subdomain
   onCancel?: () => void;
-  onProgress?: (progress: number) => void;
-  progress?: (stats: ProgressStats) => void;
+  onProgress?: (info: ProgressInfo) => void;  // Progress with percent (0-100), loaded, total bytes
   maxConcurrency?: number;
   timeout?: number;
   stripCommonPrefix?: boolean;      // Remove common path prefix
@@ -321,8 +321,8 @@ const result = await ship.deployments.create([
   './public'
 ], {
   stripCommonPrefix: true,
-  onProgress: (progress) => {
-    console.log(`Deployment: ${progress}% complete`);
+  onProgress: ({ percent }) => {
+    console.log(`Deployment: ${percent}% complete`);
   }
 });
 
@@ -346,8 +346,8 @@ const ship = new Ship({
 const fileInput = document.getElementById('fileInput') as HTMLInputElement;
 const files: File[] = Array.from(fileInput.files || []);
 const result = await ship.deployments.create(files, {
-  onProgress: (progress) => {
-    document.getElementById('progress').textContent = `${progress}%`;
+  onProgress: ({ percent }) => {
+    document.getElementById('progress').textContent = `${percent}%`;
   }
 });
 ```
@@ -691,7 +691,7 @@ import type {
   BrowserDeployInput, 
   DeployOptions,
   DeploySuccessResponse,
-  ProgressStats,
+  ProgressInfo,
   StaticFile,
   ShipError,
   ErrorType

package/dist/browser.d.ts

@@ -1,7 +1,7 @@
 import * as _shipstatic_types from '@shipstatic/types';
-import { PingResponse, ConfigResponse, StaticFile, Deployment, DeploymentListResponse, Domain, DomainListResponse, Account, TokenCreateResponse, TokenListResponse, DeployInput, DeploymentResource, DomainResource, AccountResource, TokenResource, PlatformConfig } from '@shipstatic/types';
+import { PingResponse, ConfigResponse, StaticFile, Deployment, DeploymentListResponse, Domain, DomainListResponse, Account, TokenCreateResponse, TokenListResponse, CheckoutSession, SubscriptionStatus, SubscriptionSyncResponse, DeployInput, DeploymentResource, DomainResource, AccountResource, TokenResource, SubscriptionResource, PlatformConfig, ValidatableFile, FileValidationResult } from '@shipstatic/types';
 export * from '@shipstatic/types';
-export { Account, DEFAULT_API, DeployInput, Deployment, Domain, PingResponse, ShipError, ShipErrorType } from '@shipstatic/types';
+export { Account, DEFAULT_API, DeployInput, Deployment, Domain, FileValidationStatus as FILE_VALIDATION_STATUS, PingResponse, ShipError, ShipErrorType } from '@shipstatic/types';
 
 /**
  * @file SDK-specific type definitions
@@ -35,10 +35,8 @@ interface DeploymentOptions {
     spaDetect?: boolean;
     /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators). */
     tags?: string[];
-    /** Callback for overall deploy progress (0-100). */
-    onProgress?: (progress: number) => void;
-    /** Callback for detailed progress statistics. */
-    onProgressStats?: (progressStats: ProgressStats) => void;
+    /** Callback for deploy progress with detailed statistics. */
+    onProgress?: (info: ProgressInfo) => void;
 }
 /**
  * Options for configuring an deploy operation via `apiClient.deployFiles`.
@@ -46,16 +44,17 @@ interface DeploymentOptions {
  */
 type ApiDeployOptions = Omit<DeploymentOptions, 'pathDetect'>;
 /**
- * Detailed statistics about the progress of an deploy operation.
+ * Progress information for deploy operations.
+ * Provides consistent percentage-based progress with byte-level details.
  */
-interface ProgressStats {
-    /** The number of bytes loaded so far. */
+interface ProgressInfo {
+    /** Progress percentage (0-100). */
+    percent: number;
+    /** Number of bytes loaded so far. */
     loaded: number;
-    /** The total number of bytes to be loaded. May be 0 if unknown initially. */
+    /** Total number of bytes to be loaded. May be 0 if unknown initially. */
     total: number;
-    /** The progress as a fraction (loaded/total). Value is between 0 and 1. */
-    progress: number;
-    /** Optional identifier for the file this progress pertains to, if applicable. */
+    /** Current file being processed (optional). */
     file?: string;
 }
 /**
@@ -72,15 +71,10 @@ interface ShipClientOptions {
     /** Path to custom config file. */
     configFile?: string | undefined;
     /**
-     * Default callback for overall deploy progress for deploys made with this client.
-     * @param progress - A number between 0 and 100.
+     * Default callback for deploy progress for deploys made with this client.
+     * @param info - Progress information including percentage and byte counts.
      */
-    onProgress?: ((progress: number) => void) | undefined;
-    /**
-     * Default callback for detailed progress statistics for deploys made with this client.
-     * @param progressStats - Progress statistics object.
-     */
-    onProgressStats?: ((progressStats: ProgressStats) => void) | undefined;
+    onProgress?: ((info: ProgressInfo) => void) | undefined;
     /**
      * Default for maximum concurrent deploys.
      * Used if an deploy operation doesn't specify its own `maxConcurrency`.
@@ -92,6 +86,15 @@ interface ShipClientOptions {
      * Used if an deploy operation doesn't specify its own timeout.
      */
     timeout?: number | undefined;
+    /**
+     * When true, indicates the client should use HTTP-only cookies for authentication
+     * instead of explicit tokens. This is useful for internal browser applications
+     * where authentication is handled via secure cookies set by the API.
+     *
+     * When set, the pre-request authentication check is skipped, allowing requests
+     * to proceed with cookie-based credentials.
+     */
+    useCredentials?: boolean | undefined;
 }
 /**
  * Event map for Ship SDK events
@@ -221,6 +224,23 @@ declare class ApiHttp extends SimpleEvents {
     createToken(ttl?: number, tags?: string[]): Promise<TokenCreateResponse>;
     listTokens(): Promise<TokenListResponse>;
     removeToken(token: string): Promise<void>;
+    /**
+     * Create a Creem checkout session for subscription
+     * POST /subscriptions/checkout
+     */
+    createCheckout(): Promise<CheckoutSession>;
+    /**
+     * Get current subscription status and usage
+     * GET /subscriptions/status
+     */
+    getSubscriptionStatus(): Promise<SubscriptionStatus>;
+    /**
+     * Sync subscription ID after checkout redirect
+     * POST /subscriptions/sync
+     *
+     * @param subscriptionId - Subscription ID from Creem redirect URL
+     */
+    syncSubscription(subscriptionId: string): Promise<SubscriptionSyncResponse>;
     checkSPA(files: StaticFile[]): Promise<boolean>;
     private validateFiles;
     private prepareRequestPayload;
@@ -237,6 +257,7 @@ declare function createDeploymentResource(getApi: () => ApiHttp, clientDefaults?
 declare function createDomainResource(getApi: () => ApiHttp, ensureInit?: () => Promise<void>): DomainResource;
 declare function createAccountResource(getApi: () => ApiHttp, ensureInit?: () => Promise<void>): AccountResource;
 declare function createTokenResource(getApi: () => ApiHttp, ensureInit?: () => Promise<void>): TokenResource;
+declare function createSubscriptionResource(getApi: () => ApiHttp, ensureInit?: () => Promise<void>): SubscriptionResource;
 
 /**
  * Abstract base class for Ship SDK implementations.
@@ -255,6 +276,7 @@ declare abstract class Ship$1 {
     protected _domains: DomainResource;
     protected _account: AccountResource;
     protected _tokens: TokenResource;
+    protected _subscriptions: SubscriptionResource;
     constructor(options?: ShipClientOptions);
     protected abstract resolveInitialConfig(options: ShipClientOptions): any;
     protected abstract loadFullConfig(): Promise<void>;
@@ -291,6 +313,10 @@ declare abstract class Ship$1 {
      * Get tokens resource
      */
     get tokens(): TokenResource;
+    /**
+     * Get subscriptions resource
+     */
+    get subscriptions(): SubscriptionResource;
     /**
      * Get API configuration (file upload limits, etc.)
      * Reuses platform config fetched during initialization, then caches the result
@@ -401,6 +427,35 @@ declare const JUNK_DIRECTORIES: readonly ["__MACOSX", ".Trashes", ".fseventsd",
  *
  * @param filePaths - An array of file path strings to filter
  * @returns A new array containing only non-junk file paths
+ *
+ * @example
+ * ```typescript
+ * import { filterJunk } from '@shipstatic/ship';
+ *
+ * // Filter an array of file paths
+ * const paths = ['index.html', '.DS_Store', '__MACOSX/file.txt', 'app.js'];
+ * const clean = filterJunk(paths);
+ * // Result: ['index.html', 'app.js']
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use with browser File objects
+ * import { filterJunk } from '@shipstatic/ship';
+ *
+ * const files: File[] = [...]; // From input or drag-drop
+ *
+ * // Extract paths from File objects
+ * const filePaths = files.map(f => f.webkitRelativePath || f.name);
+ *
+ * // Filter out junk paths
+ * const validPaths = new Set(filterJunk(filePaths));
+ *
+ * // Filter the original File array
+ * const validFiles = files.filter(f =>
+ *   validPaths.has(f.webkitRelativePath || f.name)
+ * );
+ * ```
  */
 declare function filterJunk(filePaths: string[]): string[];
 
@@ -467,50 +522,6 @@ declare function getENV(): ExecutionEnvironment;
  * Provides client-side validation for file uploads before deployment
  */
 
-/**
- * File status constants for validation state tracking
- */
-declare const FILE_VALIDATION_STATUS: {
-    readonly PENDING: "pending";
-    readonly PROCESSING_ERROR: "processing_error";
-    readonly EMPTY_FILE: "empty_file";
-    readonly VALIDATION_FAILED: "validation_failed";
-    readonly READY: "ready";
-};
-type FileValidationStatus = (typeof FILE_VALIDATION_STATUS)[keyof typeof FILE_VALIDATION_STATUS];
-/**
- * Client-side validation error structure
- */
-interface ValidationError {
-    error: string;
-    details: string;
-    errors: string[];
-    isClientError: true;
-}
-/**
- * Minimal file interface required for validation
- */
-interface ValidatableFile {
-    name: string;
-    size: number;
-    type: string;
-    status?: string;
-    statusMessage?: string;
-}
-/**
- * File validation result
- *
- * NOTE: Validation is ATOMIC - if any file fails validation, ALL files are rejected.
- * This ensures deployments are all-or-nothing for data integrity.
- */
-interface FileValidationResult<T extends ValidatableFile> {
-    /** All files with updated status */
-    files: T[];
-    /** Files that passed validation (empty if ANY file failed - atomic validation) */
-    validFiles: T[];
-    /** Validation error if any files failed */
-    error: ValidationError | null;
-}
 /**
  * Format file size to human-readable string
  */
@@ -625,4 +636,4 @@ declare class Ship extends Ship$1 {
     protected processInput(input: DeployInput, options: DeploymentOptions): Promise<StaticFile[]>;
 }
 
-export { type ApiDeployOptions, ApiHttp, type Config, type DeployFile, type DeploymentOptions, type ExecutionEnvironment, FILE_VALIDATION_STATUS, type FileValidationResult, type FileValidationStatus, JUNK_DIRECTORIES, type MD5Result, type ProgressStats, Ship, type ShipClientOptions, type ShipEvents, type ValidatableFile, type ValidationError, __setTestEnvironment, allValidFilesReady, calculateMD5, createAccountResource, createDeploymentResource, createDomainResource, createTokenResource, Ship as default, filterJunk, formatFileSize, getCurrentConfig, getENV, getValidFiles, loadConfig, mergeDeployOptions, optimizeDeployPaths, pluralize, processFilesForBrowser, resolveConfig, setConfig as setPlatformConfig, validateFiles };
+export { type ApiDeployOptions, ApiHttp, type Config, type DeployFile, type DeploymentOptions, type ExecutionEnvironment, JUNK_DIRECTORIES, type MD5Result, type ProgressInfo, Ship, type ShipClientOptions, type ShipEvents, __setTestEnvironment, allValidFilesReady, calculateMD5, createAccountResource, createDeploymentResource, createDomainResource, createSubscriptionResource, createTokenResource, Ship as default, filterJunk, formatFileSize, getCurrentConfig, getENV, getValidFiles, loadConfig, mergeDeployOptions, optimizeDeployPaths, pluralize, processFilesForBrowser, resolveConfig, setConfig as setPlatformConfig, validateFiles };