@shipstatic/ship 0.4.6 → 0.4.8

package/README.md

@@ -161,6 +161,13 @@ ship.domains.set('staging', { tags: ['prod', 'v2'] });
 ship.domains.set('staging', {});  // throws validation error
 ```
 
+**Domain format:** Domain names are FQDNs (Fully Qualified Domain Names). The SDK accepts any format (case-insensitive, Unicode) - the API handles normalization.
+
+```typescript
+ship.domains.set('Example.COM', { deployment: 'abc' });  // → normalized to 'example.com'
+ship.domains.set('münchen.de', { deployment: 'abc' });   // → Unicode supported
+```
+
 ### Events
 
 ```javascript

package/dist/browser.d.ts

@@ -104,7 +104,7 @@ interface ShipClientOptions {
  * Event map for Ship SDK events
  * Core events for observability: request, response, error
  */
-interface ShipEvents extends Record<string, any[]> {
+interface ShipEvents {
     /** Emitted before each API request */
     request: [url: string, init: RequestInit];
     /** Emitted after successful API response */
@@ -264,9 +264,25 @@ interface DeploymentResourceContext extends ResourceContext {
     clientDefaults?: ShipClientOptions;
     hasAuth?: () => boolean;
 }
+/**
+ * Create deployment resource with all CRUD operations.
+ */
 declare function createDeploymentResource(ctx: DeploymentResourceContext): DeploymentResource;
+/**
+ * Create domain resource with all CRUD operations.
+ *
+ * @remarks
+ * The `name` parameter in all methods is an FQDN (Fully Qualified Domain Name).
+ * The SDK does not validate or normalize domain names - the API handles all domain semantics.
+ */
 declare function createDomainResource(ctx: ResourceContext): DomainResource;
+/**
+ * Create account resource (whoami functionality).
+ */
 declare function createAccountResource(ctx: ResourceContext): AccountResource;
+/**
+ * Create token resource for managing deploy tokens.
+ */
 declare function createTokenResource(ctx: ResourceContext): TokenResource;
 
 /**
@@ -628,6 +644,8 @@ declare class Ship extends Ship$1 {
     protected resolveInitialConfig(options: ShipClientOptions): ResolvedConfig;
     protected loadFullConfig(): Promise<void>;
     protected processInput(input: DeployInput, options: DeploymentOptions): Promise<StaticFile[]>;
+    /** Type guard that validates all elements are File objects */
+    private isFileArray;
     protected getDeployBodyCreator(): DeployBodyCreator;
 }