@limrun/api 0.68.0 → 0.69.0

package/src/resources/snapshots.ts

@@ -0,0 +1,88 @@
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export interface SnapshotListParams {
+  /** Literal key prefix. Omit to list all keys. */
+  prefix?: string;
+  /** Page size: 1–500 for Xcode, 1–100 for iOS. */
+  limit?: number;
+  offset?: number;
+}
+
+export interface SnapshotList<Snapshot> {
+  snapshots: Snapshot[];
+  /** Pass as offset to read the next page. Absent on the last page. */
+  nextOffset?: number;
+}
+
+export interface XcodeSnapshot {
+  key: string;
+  directoryKey: string;
+  rootName: string;
+  paths?: string[];
+  xcodeVersionKey: string;
+  archiveFormat: string;
+  archiveSizeBytes: number;
+  sha256: string;
+  publishedAt: string;
+  sourceInstanceId?: string;
+}
+
+export interface IOSSnapshot {
+  key: string;
+  saved: boolean;
+  createdAt: string;
+  lastUsedAt: string;
+  archiveSizeBytes?: number;
+  publishedAt?: string;
+  iosVersion?: string;
+}
+
+export class XcodeSnapshots extends APIResource {
+  /** List saved workspaces, newest publication first. */
+  list(
+    organizationId: string,
+    query: SnapshotListParams = {},
+    options?: RequestOptions,
+  ): APIPromise<SnapshotList<XcodeSnapshot>> {
+    return this._client.get(path`/v1/organizations/${organizationId}/xcode_snapshots`, { query, ...options });
+  }
+
+  get(organizationId: string, key: string, options?: RequestOptions): APIPromise<XcodeSnapshot> {
+    return this._client.get(path`/v1/organizations/${organizationId}/xcode_snapshots/${key}`, options);
+  }
+
+  /** Delete the archive and index entry. Running instances can publish this key again. */
+  delete(organizationId: string, key: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/organizations/${organizationId}/xcode_snapshots/${key}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export class IOSSnapshots extends APIResource {
+  /** List simulator snapshot keys alphabetically, including keys not saved yet. */
+  list(
+    organizationId: string,
+    query: SnapshotListParams = {},
+    options?: RequestOptions,
+  ): APIPromise<SnapshotList<IOSSnapshot>> {
+    return this._client.get(path`/v1/organizations/${organizationId}/ios_snapshots`, { query, ...options });
+  }
+
+  get(organizationId: string, key: string, options?: RequestOptions): APIPromise<IOSSnapshot> {
+    return this._client.get(path`/v1/organizations/${organizationId}/ios_snapshots/${key}`, options);
+  }
+
+  /** Delete saved apps, data and the index entry. Running simulators can save this key again. */
+  delete(organizationId: string, key: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/organizations/${organizationId}/ios_snapshots/${key}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}

package/src/resources/xcode-instances-helpers.ts

@@ -5,7 +5,7 @@ import {
   type XcodeInstance,
   type XcodeInstanceCreateParams,
 } from './xcode-instances';
-import { type IosInstance } from './ios-instances';
+import { type IosInstance, type IosInstanceCreateParams } from './ios-instances';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
@@ -596,8 +596,12 @@ export type XcodeClient = {
    * Create a new iOS simulator instance and attach it to this xcode instance.
    * Deletes the simulator if attach fails so it is never leaked. Returns the new
    * simulator's instance id (record it for teardown) and the instance itself.
+   * `device` selects the simulator, for example `{ model: 'ipad' }` or an
+   * OSVersion clue. The simulator always gets no delegated permissions.
    */
-  attachNewSimulator: () => Promise<{ iosInstanceId: string; simulator: IosInstance }>;
+  attachNewSimulator: (
+    device?: Pick<IosInstanceCreateParams.Spec, 'model' | 'clues'>,
+  ) => Promise<{ iosInstanceId: string; simulator: IosInstance }>;
 
   /** Best-effort delete of a simulator instance. Never throws; returns success. */
   deleteSimulator: (iosInstanceId: string) => Promise<boolean>;
@@ -917,11 +921,15 @@ export class XcodeInstances extends GeneratedXcodeInstances {
       }
     };
 
-    const attachNewSimulatorImpl = async (): Promise<{
-      iosInstanceId: string;
-      simulator: IosInstance;
-    }> => {
-      const simulator = await client.iosInstances.create({ wait: true, spec: { role: { permissions: [] } } });
+    const attachNewSimulatorImpl: XcodeClient['attachNewSimulator'] = async (device) => {
+      const simulator = await client.iosInstances.create({
+        wait: true,
+        spec: {
+          ...(device?.model && { model: device.model }),
+          ...(device?.clues && { clues: device.clues }),
+          role: { permissions: [] },
+        },
+      });
       // The sim exists from here; if attach fails, delete it so we never leak an
       // orphan the caller can't reap.
       try {

package/src/resources/xcode-instances.ts

@@ -36,6 +36,16 @@ export class XcodeInstances extends APIResource {
     });
   }
 
+  /** Update a live instance's labels or role using the ETag returned by get().withResponse(). */
+  update(id: string, params: XcodeInstanceUpdateParams, options?: RequestOptions): APIPromise<void> {
+    const { ifMatch, ...body } = params;
+    return this._client.patch(path`/v1/xcode_instances/${id}`, {
+      ...options,
+      body,
+      headers: buildHeaders([options?.headers, { 'If-Match': ifMatch, Accept: '*/*' }]),
+    });
+  }
+
   /**
    * Get Xcode instance with given ID
    */
@@ -70,6 +80,9 @@ export namespace XcodeInstance {
   }
 
   export interface Spec {
+    /** Current effective permissions. Present on live GETs; historical records may omit it. */
+    role?: { permissions: string[] };
+
     inactivityTimeout: string;
 
     region: string;
@@ -107,6 +120,19 @@ export namespace XcodeInstance {
   }
 }
 
+export interface XcodeInstanceUpdateParams {
+  /** Quoted ETag from a live GET. A concurrent change returns HTTP 412. */
+  ifMatch: string;
+  /** Replaces all customer labels. Use {} to clear them. Omission preserves labels. */
+  metadata?: { labels: { [key: string]: string } };
+  spec?: {
+    role: {
+      /** Replaces the complete list. Use [] to remove delegated permissions. */
+      permissions: string[];
+    };
+  };
+}
+
 export interface XcodeInstanceCreateParams {
   /**
    * Query param: If there is another instance with given labels and region, return
@@ -245,6 +271,7 @@ export declare namespace XcodeInstances {
   export {
     type XcodeInstance as XcodeInstance,
     type XcodeInstancesItems as XcodeInstancesItems,
+    type XcodeInstanceUpdateParams as XcodeInstanceUpdateParams,
     type XcodeInstanceCreateParams as XcodeInstanceCreateParams,
     type XcodeInstanceListParams as XcodeInstanceListParams,
   };

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.68.0'; // x-release-please-version
+export const VERSION = '0.69.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.68.0";
+export declare const VERSION = "0.69.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.68.0";
+export declare const VERSION = "0.69.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.68.0'; // x-release-please-version
+exports.VERSION = '0.69.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.68.0'; // x-release-please-version
+export const VERSION = '0.69.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map