lazypock 0.1.2 → 0.1.5

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n// ── Codegen CLI ─────────────────────────────────────────\n// `lazypock` — fetches the live collection schema from a Lazypock\n// API and writes a fully-typed `lazypock.types.ts` module.\n//\n// Auth methods (pick one):\n//   1. Superuser email + password:\n//      npx lazypock --url http://localhost:4000/api --email admin@... --password ...\n//   2. API key (recommended, generated from the Settings dashboard):\n//      npx lazypock --url http://localhost:4000/api --api-key <key>\n//\n// Or via env vars (no flags):\n//   LAZYPOCK_URL=... LAZYPOCK_API_KEY=... npx lazypock\n//   LAZYPOCK_URL=... LAZYPOCK_EMAIL=... LAZYPOCK_PASSWORD=... npx lazypock\n//\n// NOTE: `lazypock-gen` remains as a deprecated alias for backwards\n// compatibility. Both invoke the same executable.\n\nimport { writeFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { generateTypes } from \"./codegen\";\nimport type { CollectionsResponse } from \"./schema\";\n\ninterface CliOptions {\n\turl: string;\n\temail: string;\n\tpassword: string;\n\tapiKey: string;\n\tout: string;\n\tpackageName: string;\n\tskipSystem: boolean;\n}\n\nfunction fail(msg: string): never {\n\tconsole.error(`\\n❌ ${msg}\\n`);\n\tprocess.exit(1);\n}\n\nfunction parseArgs(argv: string[]): CliOptions {\n\tconst args = [...argv];\n\tconst get = (flag: string, envKey: string, def = \"\"): string => {\n\t\tconst i = args.indexOf(flag);\n\t\tif (i !== -1 && i + 1 < args.length) return args[i + 1];\n\t\treturn process.env[envKey] ?? def;\n\t};\n\tconst has = (flag: string): boolean => args.includes(flag);\n\n\tconst url = get(\"--url\", \"LAZYPOCK_URL\");\n\tconst email = get(\"--email\", \"LAZYPOCK_EMAIL\");\n\tconst password = get(\"--password\", \"LAZYPOCK_PASSWORD\");\n\tconst apiKey = get(\"--api-key\", \"LAZYPOCK_API_KEY\");\n\n\tif (!url) fail(\"Missing API URL. Pass --url or set LAZYPOCK_URL.\");\n\tif (!apiKey) {\n\t\tif (!email)\n\t\t\tfail(\n\t\t\t\t\"Missing credentials. Pass --api-key, or --email + --password, or set LAZYPOCK_API_KEY / LAZYPOCK_EMAIL.\",\n\t\t\t);\n\t\tif (!password)\n\t\t\tfail(\"Missing password. Pass --password, or set LAZYPOCK_PASSWORD.\");\n\t}\n\n\tconst out = get(\"--out\", \"LAZYPOCK_OUT\", \"lazypock.types.ts\");\n\tconst packageName = get(\"--package\", \"LAZYPOCK_PACKAGE\", \"lazypock\");\n\n\treturn {\n\t\turl,\n\t\temail,\n\t\tpassword,\n\t\tapiKey,\n\t\tout,\n\t\tpackageName,\n\t\tskipSystem: has(\"--skip-system\"),\n\t};\n}\n\nasync function fetchCollections(\n\topts: CliOptions,\n): Promise<CollectionsResponse> {\n\tconst base = opts.url.replace(/\\/+$/, \"\");\n\n\tlet authKey: string;\n\tif (opts.apiKey) {\n\t\t// Step 1: use a stored API key directly (no login round-trip).\n\t\t// The key is sent as `Authorization: Bearer <key>` and recognised\n\t\t// by the backend's Auth.Plug as an API key.\n\t\tauthKey = opts.apiKey;\n\t} else {\n\t\t// Step 1: login as superuser to get a token\n\t\tconst loginRes = await fetch(base + \"/superusers/login\", {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\tbody: JSON.stringify({ email: opts.email, password: opts.password }),\n\t\t});\n\t\tif (!loginRes.ok) {\n\t\t\tconst text = await loginRes.text();\n\t\t\tfail(\n\t\t\t\t`Superuser login failed (${loginRes.status}). ${text.slice(0, 200)}`,\n\t\t\t);\n\t\t}\n\t\tconst loginData = (await loginRes.json()) as { token?: string };\n\t\tif (!loginData.token) fail(\"Login response did not include a token.\");\n\t\tauthKey = loginData.token;\n\t}\n\n\t// Step 2: fetch collections\n\tconst collRes = await fetch(base + \"/collections\", {\n\t\theaders: { Authorization: \"Bearer \" + authKey },\n\t});\n\tif (!collRes.ok) {\n\t\tconst text = await collRes.text();\n\t\tfail(\n\t\t\t`Failed to fetch collections (${collRes.status}). ${text.slice(0, 200)}`,\n\t\t);\n\t}\n\treturn (await collRes.json()) as CollectionsResponse;\n}\n\nasync function main(): Promise<void> {\n\tconst opts = parseArgs(process.argv.slice(2));\n\tconst authLabel = opts.apiKey\n\t\t? `API key ${opts.apiKey.slice(0, 4)}…${opts.apiKey.slice(-4)}`\n\t\t: opts.email;\n\tconsole.log(`\\n🔌 Connecting to ${opts.url} as ${authLabel} …`);\n\n\tconst { items } = await fetchCollections(opts);\n\tconsole.log(`📦 Found ${items.length} collection(s).`);\n\n\tconst source = generateTypes(items, {\n\t\tpackageName: opts.packageName,\n\t\tskipSystem: opts.skipSystem,\n\t});\n\n\tconst outPath = resolve(process.cwd(), opts.out);\n\tawait writeFile(outPath, source, \"utf8\");\n\tconsole.log(`✅ Wrote ${outPath} (${source.length} bytes).`);\n\tconsole.log(\n\t\t`\\nImport it in your app:\\n  import { createClient } from './${opts.out.replace(/\\.ts$/, \"\")}';\\n`,\n\t);\n}\n\nmain().catch((err) => {\n\tconsole.error(err);\n\tprocess.exit(1);\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n// ── Codegen CLI ─────────────────────────────────────────\n// `lazypock` — fetches the live collection schema from a Lazypock\n// API and writes a fully-typed `lazypock.types.ts` module.\n//\n// Auth methods (pick one):\n//   1. Superuser email + password:\n//      npx lazypock --url http://localhost:4000/api --email admin@... --password ...\n//   2. API key (recommended, generated from the Settings dashboard):\n//      npx lazypock --url http://localhost:4000/api --apikey <key>\n//\n// Or via env vars (no flags):\n//   LAZYPOCK_URL=... LAZYPOCK_API_KEY=... npx lazypock\n//   LAZYPOCK_URL=... LAZYPOCK_EMAIL=... LAZYPOCK_PASSWORD=... npx lazypock\n//\n// NOTE: `lazypock-gen` remains as a deprecated alias for backwards\n// compatibility. Both invoke the same executable.\n\nimport { writeFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { generateTypes } from \"./codegen\";\nimport type { CollectionsResponse } from \"./schema\";\n\ninterface CliOptions {\n\turl: string;\n\temail: string;\n\tpassword: string;\n\tapiKey: string;\n\tout: string;\n\tpackageName: string;\n\tskipSystem: boolean;\n}\n\nfunction fail(msg: string): never {\n\tconsole.error(`\\n❌ ${msg}\\n`);\n\tprocess.exit(1);\n}\n\nfunction parseArgs(argv: string[]): CliOptions {\n\tconst args = [...argv];\n\tconst get = (flag: string, envKey: string, def = \"\"): string => {\n\t\tconst i = args.indexOf(flag);\n\t\tif (i !== -1 && i + 1 < args.length) return args[i + 1];\n\t\treturn process.env[envKey] ?? def;\n\t};\n\tconst has = (flag: string): boolean => args.includes(flag);\n\n\tconst url = get(\"--url\", \"LAZYPOCK_URL\");\n\tconst email = get(\"--email\", \"LAZYPOCK_EMAIL\");\n\tconst password = get(\"--password\", \"LAZYPOCK_PASSWORD\");\n\tconst apiKey =\n\t\tget(\"--apikey\", \"LAZYPOCK_API_KEY\") || get(\"--api-key\", \"LAZYPOCK_API_KEY\");\n\n\tif (!url) fail(\"Missing API URL. Pass --url or set LAZYPOCK_URL.\");\n\tif (!apiKey) {\n\t\tif (!email)\n\t\t\tfail(\n\t\t\t\t\"Missing credentials. Pass --apikey, or --email + --password, or set LAZYPOCK_API_KEY / LAZYPOCK_EMAIL.\",\n\t\t\t);\n\t\tif (!password)\n\t\t\tfail(\"Missing password. Pass --password, or set LAZYPOCK_PASSWORD.\");\n\t}\n\n\tconst out =\n\t\tget(\"--output\", \"LAZYPOCK_OUT\") ||\n\t\tget(\"--out\", \"LAZYPOCK_OUT\", \"lazypock.types.ts\");\n\tconst packageName = get(\"--package\", \"LAZYPOCK_PACKAGE\", \"lazypock\");\n\n\treturn {\n\t\turl,\n\t\temail,\n\t\tpassword,\n\t\tapiKey,\n\t\tout,\n\t\tpackageName,\n\t\tskipSystem: has(\"--skip-system\"),\n\t};\n}\n\nasync function fetchCollections(\n\topts: CliOptions,\n): Promise<CollectionsResponse> {\n\tconst base = opts.url.replace(/\\/+$/, \"\");\n\n\tlet authKey: string;\n\tif (opts.apiKey) {\n\t\t// Step 1: use a stored API key directly (no login round-trip).\n\t\t// The key is sent as `Authorization: Bearer <key>` and recognised\n\t\t// by the backend's Auth.Plug as an API key.\n\t\tauthKey = opts.apiKey;\n\t} else {\n\t\t// Step 1: login as superuser to get a token\n\t\tconst loginRes = await fetch(base + \"/superusers/login\", {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\tbody: JSON.stringify({ email: opts.email, password: opts.password }),\n\t\t});\n\t\tif (!loginRes.ok) {\n\t\t\tconst text = await loginRes.text();\n\t\t\tfail(\n\t\t\t\t`Superuser login failed (${loginRes.status}). ${text.slice(0, 200)}`,\n\t\t\t);\n\t\t}\n\t\tconst loginData = (await loginRes.json()) as { token?: string };\n\t\tif (!loginData.token) fail(\"Login response did not include a token.\");\n\t\tauthKey = loginData.token;\n\t}\n\n\t// Step 2: fetch collections\n\tconst collRes = await fetch(base + \"/collections\", {\n\t\theaders: { Authorization: \"Bearer \" + authKey },\n\t});\n\tif (!collRes.ok) {\n\t\tconst text = await collRes.text();\n\t\tfail(\n\t\t\t`Failed to fetch collections (${collRes.status}). ${text.slice(0, 200)}`,\n\t\t);\n\t}\n\treturn (await collRes.json()) as CollectionsResponse;\n}\n\nasync function main(): Promise<void> {\n\tconst opts = parseArgs(process.argv.slice(2));\n\tconst authLabel = opts.apiKey\n\t\t? `API key ${opts.apiKey.slice(0, 4)}…${opts.apiKey.slice(-4)}`\n\t\t: opts.email;\n\tconsole.log(`\\n🔌 Connecting to ${opts.url} as ${authLabel} …`);\n\n\tconst { items } = await fetchCollections(opts);\n\tconsole.log(`📦 Found ${items.length} collection(s).`);\n\n\tconst source = generateTypes(items, {\n\t\tpackageName: opts.packageName,\n\t\tskipSystem: opts.skipSystem,\n\t});\n\n\tconst outPath = resolve(process.cwd(), opts.out);\n\tawait writeFile(outPath, source, \"utf8\");\n\tconsole.log(`✅ Wrote ${outPath} (${source.length} bytes).`);\n\tconsole.log(\n\t\t`\\nImport it in your app:\\n  import { createClient } from './${opts.out.replace(/\\.ts$/, \"\")}';\\n`,\n\t);\n}\n\nmain().catch((err) => {\n\tconsole.error(err);\n\tprocess.exit(1);\n});\n"],"mappings":";;;;;;AAkBA,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AAcxB,SAAS,KAAK,KAAoB;AACjC,UAAQ,MAAM;AAAA,SAAO,GAAG;AAAA,CAAI;AAC5B,UAAQ,KAAK,CAAC;AACf;AAEA,SAAS,UAAU,MAA4B;AAC9C,QAAM,OAAO,CAAC,GAAG,IAAI;AACrB,QAAM,MAAM,CAAC,MAAc,QAAgB,MAAM,OAAe;AAC/D,UAAM,IAAI,KAAK,QAAQ,IAAI;AAC3B,QAAI,MAAM,MAAM,IAAI,IAAI,KAAK,OAAQ,QAAO,KAAK,IAAI,CAAC;AACtD,WAAO,QAAQ,IAAI,MAAM,KAAK;AAAA,EAC/B;AACA,QAAM,MAAM,CAAC,SAA0B,KAAK,SAAS,IAAI;AAEzD,QAAM,MAAM,IAAI,SAAS,cAAc;AACvC,QAAM,QAAQ,IAAI,WAAW,gBAAgB;AAC7C,QAAM,WAAW,IAAI,cAAc,mBAAmB;AACtD,QAAM,SACL,IAAI,YAAY,kBAAkB,KAAK,IAAI,aAAa,kBAAkB;AAE3E,MAAI,CAAC,IAAK,MAAK,kDAAkD;AACjE,MAAI,CAAC,QAAQ;AACZ,QAAI,CAAC;AACJ;AAAA,QACC;AAAA,MACD;AACD,QAAI,CAAC;AACJ,WAAK,8DAA8D;AAAA,EACrE;AAEA,QAAM,MACL,IAAI,YAAY,cAAc,KAC9B,IAAI,SAAS,gBAAgB,mBAAmB;AACjD,QAAM,cAAc,IAAI,aAAa,oBAAoB,UAAU;AAEnE,SAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,IAAI,eAAe;AAAA,EAChC;AACD;AAEA,eAAe,iBACd,MAC+B;AAC/B,QAAM,OAAO,KAAK,IAAI,QAAQ,QAAQ,EAAE;AAExC,MAAI;AACJ,MAAI,KAAK,QAAQ;AAIhB,cAAU,KAAK;AAAA,EAChB,OAAO;AAEN,UAAM,WAAW,MAAM,MAAM,OAAO,qBAAqB;AAAA,MACxD,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU,EAAE,OAAO,KAAK,OAAO,UAAU,KAAK,SAAS,CAAC;AAAA,IACpE,CAAC;AACD,QAAI,CAAC,SAAS,IAAI;AACjB,YAAM,OAAO,MAAM,SAAS,KAAK;AACjC;AAAA,QACC,2BAA2B,SAAS,MAAM,MAAM,KAAK,MAAM,GAAG,GAAG,CAAC;AAAA,MACnE;AAAA,IACD;AACA,UAAM,YAAa,MAAM,SAAS,KAAK;AACvC,QAAI,CAAC,UAAU,MAAO,MAAK,yCAAyC;AACpE,cAAU,UAAU;AAAA,EACrB;AAGA,QAAM,UAAU,MAAM,MAAM,OAAO,gBAAgB;AAAA,IAClD,SAAS,EAAE,eAAe,YAAY,QAAQ;AAAA,EAC/C,CAAC;AACD,MAAI,CAAC,QAAQ,IAAI;AAChB,UAAM,OAAO,MAAM,QAAQ,KAAK;AAChC;AAAA,MACC,gCAAgC,QAAQ,MAAM,MAAM,KAAK,MAAM,GAAG,GAAG,CAAC;AAAA,IACvE;AAAA,EACD;AACA,SAAQ,MAAM,QAAQ,KAAK;AAC5B;AAEA,eAAe,OAAsB;AACpC,QAAM,OAAO,UAAU,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC5C,QAAM,YAAY,KAAK,SACpB,WAAW,KAAK,OAAO,MAAM,GAAG,CAAC,CAAC,SAAI,KAAK,OAAO,MAAM,EAAE,CAAC,KAC3D,KAAK;AACR,UAAQ,IAAI;AAAA,0BAAsB,KAAK,GAAG,OAAO,SAAS,SAAI;AAE9D,QAAM,EAAE,MAAM,IAAI,MAAM,iBAAiB,IAAI;AAC7C,UAAQ,IAAI,mBAAY,MAAM,MAAM,iBAAiB;AAErD,QAAM,SAAS,cAAc,OAAO;AAAA,IACnC,aAAa,KAAK;AAAA,IAClB,YAAY,KAAK;AAAA,EAClB,CAAC;AAED,QAAM,UAAU,QAAQ,QAAQ,IAAI,GAAG,KAAK,GAAG;AAC/C,QAAM,UAAU,SAAS,QAAQ,MAAM;AACvC,UAAQ,IAAI,gBAAW,OAAO,KAAK,OAAO,MAAM,UAAU;AAC1D,UAAQ;AAAA,IACP;AAAA;AAAA,oCAA+D,KAAK,IAAI,QAAQ,SAAS,EAAE,CAAC;AAAA;AAAA,EAC7F;AACD;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACrB,UAAQ,MAAM,GAAG;AACjB,UAAQ,KAAK,CAAC;AACf,CAAC;","names":[]}

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(index_exports, {
   ApiError: () => ApiError,
   AuthStore: () => AuthStore,
   CollectionService: () => CollectionService,
+  CollectionsService: () => CollectionsService,
   FilesService: () => FilesService,
   LazypockClient: () => LazypockClient,
   RealtimeService: () => RealtimeService,
@@ -353,17 +354,62 @@ var CollectionService = class {
     return encodeURIComponent(id);
   }
   /**
-   * List records with optional filter/sort/pagination.
-   * @param params Query parameters including `filter`, `sort`, `page`, `perPage`, `expand`.
-   * @param options Optional request options.
+   * Fetch a paginated list of records (PocketBase `getList`).
+   *
+   * @param page Page number (default 1).
+   * @param perPage Records per page (default 30).
+   * @param options Query params (`filter`, `sort`, `expand`, `fields`) + request options.
    */
-  list(params, options) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
+  getList(page = 1, perPage = 30, options) {
+    const { ...rest } = options ?? {};
+    const qs = new URLSearchParams(
+      Object.fromEntries(
+        Object.entries({ page: String(page), perPage: String(perPage), ...rest }).map(
+          ([k, v]) => [k, String(v)]
+        )
+      )
+    ).toString();
     return this.http.get(
-      "/" + this.encodeId(this.collectionName) + qs,
+      "/" + this.encodeId(this.collectionName) + "?" + qs,
       options
     );
   }
+  /**
+   * Fetch all records at once (auto-paginates). Mirrors PocketBase's
+   * `pb.collection(name).getFullList()`.
+   *
+   * @param options Query params (`sort`, `filter`, `batch`, etc.) + request options.
+   */
+  async getFullList(options) {
+    const { batch = 1e3, ...rest } = options ?? {};
+    const items = [];
+    let page = 1;
+    for (; ; ) {
+      const res = await this.getList(
+        page,
+        batch,
+        rest
+      );
+      if (!res || !res.items || res.items.length === 0) break;
+      items.push(...res.items);
+      if (page >= (res.totalPages ?? page)) break;
+      page += 1;
+    }
+    return items;
+  }
+  /**
+   * Fetch the first record matching a filter (PocketBase `getFirstListItem`).
+   *
+   * @param filter Filter expression (e.g. `title = 'x'`).
+   * @param options Optional request options.
+   */
+  async getFirstListItem(filter, options) {
+    const res = await this.getList(1, 1, {
+      ...options,
+      filter
+    });
+    return res?.items?.[0] ?? null;
+  }
   /**
    * Get a single record by ID.
    * @param id Record ID.
@@ -808,6 +854,135 @@ var FilesService = class {
   }
 };
 
+// src/collections.ts
+var REGISTRY_TOPIC = "collections";
+var CollectionsService = class {
+  /** @internal */
+  constructor(http, realtime) {
+    this.http = http;
+    this.realtime = realtime;
+  }
+  /**
+   * Fetch a paginated list of collections (admin).
+   *
+   * @param params Optional query params (`page`, `perPage`, `filter`, `sort`).
+   * @param options Optional request options.
+   */
+  async getList(params, options) {
+    const qs = params ? "?" + new URLSearchParams(
+      Object.fromEntries(
+        Object.entries(params).map(([k, v]) => [k, String(v)])
+      )
+    ).toString() : "";
+    return this.http?.get("/collections" + qs, options) ?? null;
+  }
+  /**
+   * Fetch all collections at once (auto-paginates). Mirrors PocketBase's
+   * `pb.collections.getFullList()` — defaults to listing everything.
+   *
+   * @param options Query params (`sort`, `batch`, etc.) or request options.
+   */
+  async getFullList(options) {
+    if (!this.http) return [];
+    const { batch = 1e3, ...rest } = options ?? {};
+    const items = [];
+    let page = 1;
+    for (; ; ) {
+      const res = await this.getList({
+        ...rest,
+        page,
+        perPage: batch
+      });
+      if (!res || !res.items || res.items.length === 0) break;
+      items.push(...res.items);
+      if (page >= (res.totalPages ?? page)) break;
+      page += 1;
+    }
+    return items;
+  }
+  /**
+   * Get a single collection by ID or name (admin).
+   *
+   * @param id Collection ID or name.
+   * @param options Optional request options.
+   */
+  async getOne(id, options) {
+    return this.http?.get("/collections/" + encodeURIComponent(id), options) ?? null;
+  }
+  /**
+   * Create a new collection (admin).
+   *
+   * @param data Collection definition (name, type, fields, options, rules, etc.).
+   * @param options Optional request options.
+   */
+  async create(data, options) {
+    return this.http?.post("/collections", data, options) ?? null;
+  }
+  /**
+   * Update an existing collection (admin).
+   *
+   * @param id Collection ID or name.
+   * @param data Updated collection fields.
+   * @param options Optional request options.
+   */
+  async update(id, data, options) {
+    return this.http?.patch(
+      "/collections/" + encodeURIComponent(id),
+      data,
+      options
+    ) ?? null;
+  }
+  /**
+   * Delete a collection (admin).
+   *
+   * @param id Collection ID or name.
+   * @param options Optional request options.
+   */
+  async delete(id, options) {
+    const res = this.http?.delete(
+      "/collections/" + encodeURIComponent(id),
+      options
+    );
+    return res == null ? false : true;
+  }
+  /**
+   * Subscribe to collection registry changes.
+   *
+   * @param callback Received on every collection create/update/delete.
+   * @returns A function that unsubscribes this callback.
+   */
+  subscribe(callback) {
+    if (!this.realtime) {
+      console.warn("[lazypock] No realtime service configured.");
+      return () => {
+      };
+    }
+    const handler = (raw) => {
+      callback({
+        action: normalizeAction2(raw.event),
+        collection: raw.payload ?? {},
+        topic: raw.topic
+      });
+    };
+    this.realtime.ensureConnected();
+    this.realtime.subscribe(REGISTRY_TOPIC, handler);
+    return () => this.realtime?.unsubscribe(REGISTRY_TOPIC, handler);
+  }
+  /**
+   * Unsubscribe all callbacks from the registry channel.
+   */
+  unsubscribe() {
+    this.realtime?.unsubscribe(REGISTRY_TOPIC);
+  }
+};
+function normalizeAction2(event) {
+  const e = event.toLowerCase();
+  if (e === "create") return "create";
+  if (e === "update") return "update";
+  if (e === "delete") return "delete";
+  return "update";
+}
+
 // src/typegen.ts
 function fieldTypeScriptType(field, fallback = "unknown") {
   const opts = field.options ?? {};
@@ -968,11 +1143,13 @@ export function createClient(options: LazypockClientOptions): TypedClient {
 }
 
 export class TypedClient extends LazypockClient {
-  override collection<K extends keyof LazypockCollections>(name: K): CollectionService<LazypockCollections[K]>;
-  override collection(name: string): CollectionService<unknown> {
-    return super.collection(name) as unknown as CollectionService<unknown>;
+  override collection<T extends string>(name: T): T extends keyof LazypockCollections
+    ? CollectionService<LazypockCollections[T]>
+    : CollectionService<unknown> {
+    return super.collection(name) as T extends keyof LazypockCollections ? CollectionService<LazypockCollections[T]> : CollectionService<unknown>;
   }
-}`);
+}
+`);
   return sections.join("\n\n") + "\n";
 }
 function renderInterface(opts) {
@@ -1006,6 +1183,7 @@ var LazypockClient = class {
       this.realtime.setUrl(wsUrlFromBaseUrl(baseUrl));
     }
     this.files = new FilesService(this.http);
+    this.collections = new CollectionsService(this.http, this.realtime);
     if (options.types?.schemas) {
       this.schemaByName = new Map(
         options.types.schemas.map((s) => [s.name, s])
@@ -1166,129 +1344,6 @@ var LazypockClient = class {
   health(options) {
     return this.http.get("/health", options);
   }
-  // ── Collection Management (admin) ──
-  /**
-   * List all collections (admin).
-   * @param q URL query string (e.g. `page=1&perPage=200`).
-   * @param options Optional request options.
-   */
-  listCollections(q, options) {
-    return this.http.get(
-      "/collections" + (q ? "?" + q : ""),
-      options
-    );
-  }
-  /**
-   * Get a single collection by ID or name.
-   * @param id Collection ID or name.
-   * @param options Optional request options.
-   */
-  getCollection(id, options) {
-    return this.http.get(
-      "/collections/" + encodeURIComponent(id),
-      options
-    );
-  }
-  /**
-   * Create a new collection (admin).
-   * @param data Collection definition (name, type, fields, options, rules, etc.).
-   * @param options Optional request options.
-   */
-  createCollection(data, options) {
-    return this.http.post("/collections", data, options);
-  }
-  /**
-   * Update an existing collection (admin).
-   * @param id Collection ID or name.
-   * @param data Updated collection fields.
-   * @param options Optional request options.
-   */
-  updateCollection(id, data, options) {
-    return this.http.patch(
-      "/collections/" + encodeURIComponent(id),
-      data,
-      options
-    );
-  }
-  /**
-   * Delete a collection (admin).
-   * @param id Collection ID or name.
-   * @param options Optional request options.
-   */
-  deleteCollection(id, options) {
-    return this.http.delete("/collections/" + encodeURIComponent(id), options);
-  }
-  // ── Records (dynamic collection) ──
-  /**
-   * List records from a dynamic collection with optional filter/sort/pagination.
-   *
-   * @param coll Collection name.
-   * @param params Query parameters including:
-   *   - `filter` — PocketBase filter syntax (e.g. `title~'hello' && published=true`)
-   *   - `sort` — Comma-separated, `-` prefix for DESC (e.g. `-created,title`)
-   *   - `page` — Page number (default: 1)
-   *   - `perPage` — Items per page (default: 30, max: 200)
-   *   - `expand` — Comma-separated relation fields (e.g. `author,category`)
-   * @param options Optional request options.
-   */
-  listRecords(coll, params, options) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.http.get(
-      "/" + encodeURIComponent(coll) + qs,
-      options
-    );
-  }
-  /**
-   * Get a single record by ID.
-   * @param coll Collection name.
-   * @param id Record ID.
-   * @param options Optional request options.
-   */
-  getRecord(coll, id, options) {
-    return this.http.get(
-      "/" + encodeURIComponent(coll) + "/" + encodeURIComponent(id),
-      options
-    );
-  }
-  /**
-   * Create a record in a dynamic collection.
-   * @param coll Collection name.
-   * @param data Record fields.
-   * @param options Optional request options.
-   */
-  createRecord(coll, data, options) {
-    return this.http.post(
-      "/" + encodeURIComponent(coll),
-      data,
-      options
-    );
-  }
-  /**
-   * Update a record in a dynamic collection.
-   * @param coll Collection name.
-   * @param id Record ID.
-   * @param data Updated record fields.
-   * @param options Optional request options.
-   */
-  updateRecord(coll, id, data, options) {
-    return this.http.patch(
-      "/" + encodeURIComponent(coll) + "/" + encodeURIComponent(id),
-      data,
-      options
-    );
-  }
-  /**
-   * Delete a record from a dynamic collection.
-   * @param coll Collection name.
-   * @param id Record ID.
-   * @param options Optional request options.
-   */
-  deleteRecord(coll, id, options) {
-    return this.http.delete(
-      "/" + encodeURIComponent(coll) + "/" + encodeURIComponent(id),
-      options
-    );
-  }
 };
 
 // src/client.ts
@@ -1305,6 +1360,7 @@ function createClient(options) {
   ApiError,
   AuthStore,
   CollectionService,
+  CollectionsService,
   FilesService,
   LazypockClient,
   RealtimeService,