@shipstatic/types 0.2.8 → 0.2.9

package/dist/index.d.ts

@@ -103,6 +103,45 @@ export interface DeploymentRemoveResponse {
     /** Human-readable message */
     message?: string;
 }
+/**
+ * Deployment token for automated deployments
+ */
+export interface Token {
+    /** The token hash (not the actual token value) */
+    readonly token: string;
+    /** The account this token belongs to */
+    readonly account: string;
+    /** Optional IP address binding for security */
+    readonly ip?: string;
+    /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators) */
+    tags?: string[];
+    /** Unix timestamp (seconds) when token was created */
+    readonly created: number;
+    /** Unix timestamp (seconds) when token expires, or null for never */
+    readonly expires?: number;
+    /** Unix timestamp (seconds) when token was last used */
+    readonly used?: number;
+}
+/**
+ * Response for listing tokens
+ */
+export interface TokenListResponse {
+    /** Array of tokens */
+    tokens: Token[];
+    /** Total count of tokens */
+    count?: number;
+}
+/**
+ * Response for token creation
+ */
+export interface TokenCreateResponse {
+    /** The actual token value (only returned on creation) */
+    token: string;
+    /** Unix timestamp (seconds) when token expires, or null for never */
+    expires?: number;
+    /** Success message */
+    message?: string;
+}
 /**
  * Account plan constants
  */
@@ -372,6 +411,14 @@ export interface AliasResource {
 export interface AccountResource {
     get: () => Promise<Account>;
 }
+/**
+ * Token resource interface - the contract all implementations must follow
+ */
+export interface TokenResource {
+    create: (ttl?: number, tags?: string[]) => Promise<TokenCreateResponse>;
+    list: () => Promise<TokenListResponse>;
+    remove: (token: string) => Promise<void>;
+}
 /**
  * Keys resource interface - the contract all implementations must follow
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipstatic/types",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Shared types for Shipstatic platform",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -122,6 +122,52 @@ export interface DeploymentRemoveResponse {
   message?: string;
 }
 
+// =============================================================================
+// TOKEN TYPES
+// =============================================================================
+
+/**
+ * Deployment token for automated deployments
+ */
+export interface Token {
+  /** The token hash (not the actual token value) */
+  readonly token: string;
+  /** The account this token belongs to */
+  readonly account: string;
+  /** Optional IP address binding for security */
+  readonly ip?: string;
+  /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators) */
+  tags?: string[];
+  /** Unix timestamp (seconds) when token was created */
+  readonly created: number;
+  /** Unix timestamp (seconds) when token expires, or null for never */
+  readonly expires?: number;
+  /** Unix timestamp (seconds) when token was last used */
+  readonly used?: number;
+}
+
+/**
+ * Response for listing tokens
+ */
+export interface TokenListResponse {
+  /** Array of tokens */
+  tokens: Token[];
+  /** Total count of tokens */
+  count?: number;
+}
+
+/**
+ * Response for token creation
+ */
+export interface TokenCreateResponse {
+  /** The actual token value (only returned on creation) */
+  token: string;
+  /** Unix timestamp (seconds) when token expires, or null for never */
+  expires?: number;
+  /** Success message */
+  message?: string;
+}
+
 // =============================================================================
 // ACCOUNT TYPES
 // =============================================================================
@@ -609,6 +655,15 @@ export interface AccountResource {
   get: () => Promise<Account>;
 }
 
+/**
+ * Token resource interface - the contract all implementations must follow
+ */
+export interface TokenResource {
+  create: (ttl?: number, tags?: string[]) => Promise<TokenCreateResponse>;
+  list: () => Promise<TokenListResponse>;
+  remove: (token: string) => Promise<void>;
+}
+
 /**
  * Keys resource interface - the contract all implementations must follow
  */