@shipstatic/ship 0.3.3 → 0.3.5

package/README.md

@@ -231,14 +231,21 @@ await ship.deployments.get(id)
 
 #### Deploy Input Types
 
-**Node.js Environment:**
 ```typescript
-type NodeDeployInput = string[];  // File paths
+type DeployInput = File[] | string | string[];
 ```
 
+**Node.js Environment:**
+- `string` - Single file or directory path
+- `string[]` - Multiple file/directory paths
+
 **Browser Environment:**
+- `File[]` - Array of File objects
+
+**Note:** For `<input type="file">` elements, convert FileList to File[]:
 ```typescript
-type BrowserDeployInput = FileList | File[] | HTMLInputElement;
+const files = Array.from(fileInput.files);
+await ship.deploy(files);
 ```
 
 #### Deploy Options
@@ -335,17 +342,14 @@ const ship = new Ship({
   apiKey: 'ship-your-64-char-hex-string'  // 69 chars total
 });
 
-// From file input
+// From file input - convert FileList to File[]
 const fileInput = document.getElementById('fileInput') as HTMLInputElement;
-const result = await ship.deployments.create(fileInput, {
+const files: File[] = Array.from(fileInput.files || []);
+const result = await ship.deployments.create(files, {
   onProgress: (progress) => {
     document.getElementById('progress').textContent = `${progress}%`;
   }
 });
-
-// From File objects
-const files: File[] = Array.from(fileInput.files || []);
-const result2 = await ship.deployments.create(files);
 ```
 
 ## Event System

package/dist/browser.d.ts

@@ -159,9 +159,10 @@ declare class SimpleEvents {
  */
 declare class ApiHttp extends SimpleEvents {
     private readonly apiUrl;
-    private readonly apiKey;
-    private readonly deployToken;
-    constructor(options: ShipClientOptions);
+    private readonly getAuthHeadersCallback;
+    constructor(options: ShipClientOptions & {
+        getAuthHeaders: () => Record<string, string>;
+    });
     /**
      * Transfer events to another client (clean intentional API)
      */
@@ -171,13 +172,9 @@ declare class ApiHttp extends SimpleEvents {
      */
     private request;
     /**
-     * Generate auth headers
+     * Generate auth headers from Ship instance callback
      */
     private getAuthHeaders;
-    /**
-     * Check if credentials are needed
-     */
-    private needsCredentials;
     /**
      * Safely clone response for events
      */
@@ -236,7 +233,7 @@ declare class ApiHttp extends SimpleEvents {
  * @file Ship SDK resource implementations for deployments, domains, and accounts.
  */
 
-declare function createDeploymentResource(getApi: () => ApiHttp, clientDefaults?: ShipClientOptions, ensureInit?: () => Promise<void>, processInput?: (input: DeployInput, options: DeploymentOptions) => Promise<StaticFile[]>): DeploymentResource;
+declare function createDeploymentResource(getApi: () => ApiHttp, clientDefaults?: ShipClientOptions, ensureInit?: () => Promise<void>, processInput?: (input: DeployInput, options: DeploymentOptions) => Promise<StaticFile[]>, hasAuth?: () => boolean): DeploymentResource;
 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;
@@ -252,6 +249,8 @@ declare abstract class Ship$1 {
     protected readonly clientOptions: ShipClientOptions;
     protected initPromise: Promise<void> | null;
     protected _config: ConfigResponse | null;
+    private auth;
+    private readonly authHeadersCallback;
     protected _deployments: DeploymentResource;
     protected _domains: DomainResource;
     protected _account: AccountResource;
@@ -315,6 +314,30 @@ declare abstract class Ship$1 {
      * @protected
      */
     protected replaceHttpClient(newClient: ApiHttp): void;
+    /**
+     * Sets the deploy token for authentication.
+     * This will override any previously set API key or deploy token.
+     * @param token The deploy token (format: token-<64-char-hex>)
+     */
+    setDeployToken(token: string): void;
+    /**
+     * Sets the API key for authentication.
+     * This will override any previously set API key or deploy token.
+     * @param key The API key (format: ship-<64-char-hex>)
+     */
+    setApiKey(key: string): void;
+    /**
+     * Generate authorization headers based on current auth state
+     * Called dynamically on each request to ensure latest credentials are used
+     * @private
+     */
+    private getAuthHeaders;
+    /**
+     * Check if authentication credentials are configured
+     * Used by resources to fail fast if auth is required
+     * @private
+     */
+    private hasAuth;
 }
 
 /**
@@ -561,15 +584,15 @@ declare function getCurrentConfig(): ConfigResponse;
  */
 
 /**
- * Processes browser files (FileList or File[]) into an array of StaticFile objects ready for deploy.
+ * Processes browser files into an array of StaticFile objects ready for deploy.
  * Calculates MD5, filters junk files, and applies automatic path optimization.
  *
- * @param browserFiles - FileList or File[] to process for deploy.
+ * @param browserFiles - File[] to process for deploy.
  * @param options - Processing options including pathDetect for automatic path optimization.
  * @returns Promise resolving to an array of StaticFile objects.
  * @throws {ShipClientError} If called outside a browser or with invalid input.
  */
-declare function processFilesForBrowser(browserFiles: FileList | File[], options?: DeploymentOptions): Promise<StaticFile[]>;
+declare function processFilesForBrowser(browserFiles: File[], options?: DeploymentOptions): Promise<StaticFile[]>;
 
 /**
  * @file Ship SDK for browser environments with streamlined configuration.
@@ -590,7 +613,7 @@ declare function processFilesForBrowser(browserFiles: FileList | File[], options
  * });
  *
  * // Deploy files from input element
- * const files = fileInput.files;
+ * const files = Array.from(fileInput.files);
  * await ship.deploy(files);
  * ```
  */