@runtypelabs/sdk 6.5.1 → 6.6.1

package/dist/index.cjs

@@ -89,6 +89,7 @@ __export(index_exports, {
   ToolEnsureConflictError: () => ToolEnsureConflictError,
   ToolsEndpoint: () => ToolsEndpoint,
   ToolsNamespace: () => ToolsNamespace,
+  TypedRecordsScope: () => TypedRecordsScope,
   UNIFIED_EVENTS_QUERY: () => UNIFIED_EVENTS_QUERY,
   UsersEndpoint: () => UsersEndpoint,
   applyGeneratedRuntimeToolProposalToDispatchRequest: () => applyGeneratedRuntimeToolProposalToDispatchRequest,
@@ -6448,7 +6449,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "6.5.1".length > 0 ? "6.5.1" : FALLBACK_VERSION;
+var SDK_VERSION = "6.6.1".length > 0 ? "6.6.1" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 
@@ -8695,6 +8696,69 @@ var RecordsEndpoint = class {
       limit: 1
     });
   }
+  /**
+   * Scope record operations to a single collection slug, typing `metadata`
+   * against the customer-augmented `RecordCollections` map (§5.1). The returned
+   * scope pins the record `type` filter to `slug` and types `.list/.get/.create/
+   * .update` metadata as `CollectionMeta<S>`.
+   *
+   * @example
+   * ```ts
+   * const customers = client.records.from('customers')
+   * await customers.create({ name: 'Acme', metadata: { tier: 'pro' } })
+   * ```
+   */
+  from(slug) {
+    return new TypedRecordsScope(this.client, slug);
+  }
+};
+var TypedRecordsScope = class {
+  constructor(client, slug) {
+    this.client = client;
+    this.slug = slug;
+  }
+  /** List records of this collection (the `type` filter is pinned to the slug). */
+  async list(params) {
+    return this.client.get("/records", {
+      ...params,
+      type: this.slug
+    });
+  }
+  /**
+   * Get a record of this collection by id. Throws if the fetched record belongs
+   * to a different collection — otherwise `metadata` would be mistyped as this
+   * scope's shape. Use `client.records.get()` for cross-collection reads.
+   */
+  async get(id) {
+    const record = await this.client.get(`/records/${id}`);
+    const type = record.type;
+    if (type !== void 0 && type !== this.slug) throw this.typeMismatchError(id, type);
+    return record;
+  }
+  /** Create a record in this collection (`type` is supplied from the slug). */
+  async create(data) {
+    return this.client.post("/records", {
+      ...data,
+      type: this.slug
+    });
+  }
+  /**
+   * Update a record in this collection. Guards BEFORE writing with a GET: this
+   * scope's `metadata` type must not be written onto a record of another
+   * collection, so a cross-collection id throws instead of mutating. That costs
+   * one extra request; use `client.records.update()` to skip the guard.
+   */
+  async update(id, data) {
+    const existing = await this.client.get(`/records/${id}`);
+    const type = existing?.type;
+    if (type !== void 0 && type !== this.slug) throw this.typeMismatchError(id, type);
+    return this.client.put(`/records/${id}`, data);
+  }
+  typeMismatchError(id, actualType) {
+    return new Error(
+      `Record ${id} belongs to collection "${actualType}", not "${this.slug}". Use client.records.from("${actualType}") or the untyped client.records methods for cross-collection access.`
+    );
+  }
 };
 var CollectionsEndpoint = class {
   constructor(client) {
@@ -8758,6 +8822,15 @@ var CollectionsEndpoint = class {
       data ?? {}
     );
   }
+  /**
+   * Fetch generated TypeScript declarations for the account's schematized
+   * collections (`GET /v1/collections/types.d.ts`) as a raw `.d.ts` string.
+   * Powers `runtype records typegen`; write it to a file and augment the SDK's
+   * `RecordCollections` map so `client.records.from(slug)` types metadata.
+   */
+  async typegen() {
+    return this.client.get("/collections/types.d.ts");
+  }
 };
 var ApiKeysEndpoint = class {
   constructor(client) {
@@ -14243,6 +14316,7 @@ var STEP_TYPE_TO_METHOD = {
   ToolEnsureConflictError,
   ToolsEndpoint,
   ToolsNamespace,
+  TypedRecordsScope,
   UNIFIED_EVENTS_QUERY,
   UsersEndpoint,
   applyGeneratedRuntimeToolProposalToDispatchRequest,