@seamapi/http 1.25.0 → 1.26.0

package/README.md

@@ -329,6 +329,32 @@ if (hasNextPage) {
 }
 ```
 
+#### Resume pagination
+
+Get the first page on initial load:
+
+```ts
+const params = { limit: 20 }
+
+const pages = seam.createPaginator(seam.devices.list(params))
+
+const [devices, pagination] = await pages.firstPage()
+
+localStorage.setItem('/seam/devices/list', JSON.stringify([params, pagination]))
+```
+
+Get the next page at a later time:
+
+```ts
+const [params = {}, { hasNextPage = false, nextPageCursor = null } = {}] =
+  JSON.parse(localStorage.getItem('/seam/devices/list') ?? '[]')
+
+if (hasNextPage) {
+  const pages = seam.createPaginator(seam.devices.list(params))
+  const [moreDevices] = await pages.nextPage(nextPageCursor)
+}
+```
+
 #### Iterate over all pages
 
 ```ts
@@ -366,7 +392,7 @@ const pages = seam.createPaginator(
   }),
 )
 
-const devices = await pages.toArray()
+const devices = await pages.flattenToArray()
 ```
 
 ### Interacting with Multiple Workspaces

package/dist/connect.cjs

@@ -4855,6 +4855,144 @@ var SeamHttpThermostats = class _SeamHttpThermostats {
   }
 };
 
+// src/lib/seam/connect/routes/unstable-locations.ts
+var SeamHttpUnstableLocations = class _SeamHttpUnstableLocations {
+  constructor(apiKeyOrOptions = {}) {
+    const options = parseOptions(apiKeyOrOptions);
+    this.client = "client" in options ? options.client : createClient(options);
+    this.defaults = limitToSeamHttpRequestOptions(options);
+  }
+  static fromClient(client, options = {}) {
+    const constructorOptions = { ...options, client };
+    if (!isSeamHttpOptionsWithClient(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError("Missing client");
+    }
+    return new _SeamHttpUnstableLocations(constructorOptions);
+  }
+  static fromApiKey(apiKey, options = {}) {
+    const constructorOptions = { ...options, apiKey };
+    if (!isSeamHttpOptionsWithApiKey(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError("Missing apiKey");
+    }
+    return new _SeamHttpUnstableLocations(constructorOptions);
+  }
+  static fromClientSessionToken(clientSessionToken, options = {}) {
+    const constructorOptions = { ...options, clientSessionToken };
+    if (!isSeamHttpOptionsWithClientSessionToken(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError("Missing clientSessionToken");
+    }
+    return new _SeamHttpUnstableLocations(constructorOptions);
+  }
+  static async fromPublishableKey(publishableKey, userIdentifierKey, options = {}) {
+    warnOnInsecureuserIdentifierKey(userIdentifierKey);
+    const clientOptions = parseOptions({ ...options, publishableKey });
+    if (isSeamHttpOptionsWithClient(clientOptions)) {
+      throw new SeamHttpInvalidOptionsError(
+        "The client option cannot be used with SeamHttp.fromPublishableKey"
+      );
+    }
+    const client = createClient(clientOptions);
+    const clientSessions = SeamHttpClientSessions.fromClient(client);
+    const { token } = await clientSessions.getOrCreate({
+      user_identifier_key: userIdentifierKey
+    });
+    return _SeamHttpUnstableLocations.fromClientSessionToken(token, options);
+  }
+  static fromConsoleSessionToken(consoleSessionToken, workspaceId, options = {}) {
+    const constructorOptions = { ...options, consoleSessionToken, workspaceId };
+    if (!isSeamHttpOptionsWithConsoleSessionToken(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError(
+        "Missing consoleSessionToken or workspaceId"
+      );
+    }
+    return new _SeamHttpUnstableLocations(constructorOptions);
+  }
+  static fromPersonalAccessToken(personalAccessToken, workspaceId, options = {}) {
+    const constructorOptions = { ...options, personalAccessToken, workspaceId };
+    if (!isSeamHttpOptionsWithPersonalAccessToken(constructorOptions)) {
+      throw new SeamHttpInvalidOptionsError(
+        "Missing personalAccessToken or workspaceId"
+      );
+    }
+    return new _SeamHttpUnstableLocations(constructorOptions);
+  }
+  createPaginator(request) {
+    return new SeamPaginator(this, request);
+  }
+  async updateClientSessionToken(clientSessionToken) {
+    const { headers } = this.client.defaults;
+    const authHeaders = getAuthHeadersForClientSessionToken({
+      clientSessionToken
+    });
+    for (const key of Object.keys(authHeaders)) {
+      if (headers[key] == null) {
+        throw new Error(
+          "Cannot update a clientSessionToken on a client created without a clientSessionToken"
+        );
+      }
+    }
+    this.client.defaults.headers = { ...headers, ...authHeaders };
+    const clientSessions = SeamHttpClientSessions.fromClient(this.client);
+    await clientSessions.get();
+  }
+  addDevices(body) {
+    return new SeamHttpRequest(this, {
+      pathname: "/unstable_locations/add_devices",
+      method: "post",
+      body,
+      responseKey: void 0
+    });
+  }
+  create(body) {
+    return new SeamHttpRequest(this, {
+      pathname: "/unstable_locations/create",
+      method: "post",
+      body,
+      responseKey: "location"
+    });
+  }
+  delete(body) {
+    return new SeamHttpRequest(this, {
+      pathname: "/unstable_locations/delete",
+      method: "post",
+      body,
+      responseKey: void 0
+    });
+  }
+  get(body) {
+    return new SeamHttpRequest(this, {
+      pathname: "/unstable_locations/get",
+      method: "post",
+      body,
+      responseKey: "location"
+    });
+  }
+  list(body) {
+    return new SeamHttpRequest(this, {
+      pathname: "/unstable_locations/list",
+      method: "post",
+      body,
+      responseKey: "locations"
+    });
+  }
+  removeDevices(body) {
+    return new SeamHttpRequest(this, {
+      pathname: "/unstable_locations/remove_devices",
+      method: "post",
+      body,
+      responseKey: void 0
+    });
+  }
+  update(body) {
+    return new SeamHttpRequest(this, {
+      pathname: "/unstable_locations/update",
+      method: "post",
+      body,
+      responseKey: "location"
+    });
+  }
+};
+
 // src/lib/seam/connect/routes/user-identities-enrollment-automations.ts
 var SeamHttpUserIdentitiesEnrollmentAutomations = class _SeamHttpUserIdentitiesEnrollmentAutomations {
   constructor(apiKeyOrOptions = {}) {
@@ -5614,6 +5752,7 @@ exports.SeamHttpThermostats = SeamHttpThermostats;
 exports.SeamHttpThermostatsSchedules = SeamHttpThermostatsSchedules;
 exports.SeamHttpThermostatsSimulate = SeamHttpThermostatsSimulate;
 exports.SeamHttpUnauthorizedError = SeamHttpUnauthorizedError;
+exports.SeamHttpUnstableLocations = SeamHttpUnstableLocations;
 exports.SeamHttpUserIdentities = SeamHttpUserIdentities;
 exports.SeamHttpUserIdentitiesEnrollmentAutomations = SeamHttpUserIdentitiesEnrollmentAutomations;
 exports.SeamHttpWebhooks = SeamHttpWebhooks;