lazypock 0.8.3 → 0.9.0

package/src/codegen.ts

@@ -90,9 +90,15 @@ export function generateTypes(
 		// intentionally includes password fields (and hidden fields) that are
 		// excluded from the read model — the server accepts them on write,
 		// hashes passwords, and never returns them in responses.
-		const createLines = fields
-			.map((f) => createDataMemberLine(f))
-			.filter((l) => l !== "");
+		const createLines: string[] = [];
+		const seenKeys = new Set<string>();
+		for (const f of fields) {
+			for (const { key, line } of createDataMemberLines(f)) {
+				if (seenKeys.has(key)) continue;
+				seenKeys.add(key);
+				createLines.push(line);
+			}
+		}
 		sections.push(
 			`export interface ${typeName}CreateData${renderInterface({
 				body: createLines.join("\n"),
@@ -227,28 +233,49 @@ function memberLine(f: SchemaField): string {
 }
 
 /**
- * Render a write-only create-data member for a field.
+ * Render the write-only create-data members for a field.
  *
  * Unlike the read model, create/update data includes password fields (sent as
  * plain strings — the server hashes them) and hidden fields: the server
  * accepts them on write and never returns them in responses.
  *
+ * Password fields are exposed under the canonical PocketBase API key
+ * `password` (the server accepts `password` for any single password field and
+ * hashes it into the backing column, e.g. `password_hash`), with the raw
+ * metadata name kept as a backward-compat alias.
+ *
  * A field is only marked required when it actually needs a client value:
  * fields with a server-side default (`options.defaultValue`) and the auth
  * system fields `verified` / `emailVisibility` (the server defaults them to
  * false/true even though the snapshot doesn't carry `defaultValue`) stay
- * optional, so `create({ email, password_hash })` typechecks without forcing
- * callers to send values the server would fill in anyway.
+ * optional, so `create({ email, password })` typechecks without forcing
+ * callers to send values the server would fill in anyway. Password fields
+ * are optional (accounts may exist without a password, e.g. OAuth-only).
  */
-function createDataMemberLine(f: SchemaField): string {
+function createDataMemberLines(
+	f: SchemaField,
+): { key: string; line: string }[] {
 	// Autodate columns are server-managed; never writable.
-	if (f.type === "autodate") return "";
-	const key = fieldKey(f.name);
+	if (f.type === "autodate") return [];
+	const rawName = fieldKey(f.name);
 	const serverDefaulted =
 		f.options?.defaultValue !== undefined ||
 		(f.system && (f.name === "verified" || f.name === "emailVisibility"));
 	const req = f.required && !serverDefaulted ? "" : "?";
 	const type = f.type === "password" ? "string" : fieldTypeScriptType(f);
-	if (type === "never") return "";
-	return `  ${JSON.stringify(key)}${req}: ${type};`;
+	if (type === "never") return [];
+
+	const members = [
+		{ key: rawName, line: `  ${JSON.stringify(rawName)}${req}: ${type};` },
+	];
+	// Write-only password: canonical key is `password` (PocketBase parity) —
+	// the server accepts `password` for any single password field and hashes
+	// it. The raw metadata name (e.g. `password_hash`) stays as a compat alias.
+	if (f.type === "password" && rawName !== "password") {
+		members.unshift({
+			key: "password",
+			line: `  ${JSON.stringify("password")}${req}: ${type};`,
+		});
+	}
+	return members;
 }

package/src/collection.ts

@@ -60,6 +60,23 @@ export interface RealtimeMessage {
 /** Subscription callback for a collection's realtime events. */
 export type RealtimeCallback = (e: RealtimeMessage) => void;
 
+/**
+ * Options for {@link CollectionService.subscribe} (PocketBase-compatible).
+ *
+ * `expand` and any extra keys are forwarded to the server channel join
+ * payload (available to `onRealtimeSubscribeRequest` hooks). `headers` is
+ * accepted for PocketBase signature compatibility but has no effect over
+ * WebSocket — it is not forwarded.
+ */
+export interface RealtimeSubscribeOptions {
+	/** Fields to expand on the subscribed records (server join payload). */
+	expand?: string;
+	/** Accepted for PocketBase parity; not sent over the WebSocket. */
+	headers?: Record<string, string>;
+	/** Any extra keys are forwarded verbatim to the server join payload. */
+	[key: string]: unknown;
+}
+
 /** Raw event passed by the low-level realtime service. */
 interface RealtimeEventLike {
 	event: string;
@@ -505,23 +522,64 @@ export class CollectionService<T = ApiRecord, TData = never> {
 
 	/**
 	 * Subscribe to realtime changes for this collection.
-	 * The event's `action` is one of `"create" | "update" | "delete"`.
+	 * The event's `action` is one of `"create" | "update" | "delete"` and the
+	 * callback always receives the **full record** (all fields, regardless of
+	 * any `select()` projection on the service).
 	 *
 	 * Access is governed by the collection's `listRule` (PocketBase semantics):
 	 * public collections allow anonymous subscriptions; other collections
 	 * require a matching logged-in user or superuser.
 	 *
-	 * @param callback Received on every record change.
-	 * @param recordId Optional — subscribe to a single record instead of `*`.
+	 * PocketBase-compatible argument forms:
+	 *   - `subscribe(cb)` — all records of the collection
+	 *   - `subscribe('*', cb)` — all records (explicit wildcard)
+	 *   - `subscribe('RECORD_ID', cb)` — a single record
+	 *   - `subscribe('*' | 'RECORD_ID', cb, options)` — with join options
+	 *
+	 * Legacy form (callback first) is still accepted: `subscribe(cb, recordId)`.
+	 *
 	 * @returns A function that unsubscribes this callback.
 	 */
-	subscribe(callback: RealtimeCallback, recordId?: string): () => void {
+	subscribe(callback: RealtimeCallback): () => void;
+	subscribe(
+		recordId: string,
+		callback: RealtimeCallback,
+		options?: RealtimeSubscribeOptions,
+	): () => void;
+	/** @deprecated Use `subscribe(recordId, callback)` — PocketBase order. */
+	subscribe(callback: RealtimeCallback, recordId?: string): () => void;
+	subscribe(
+		topicOrCallback: string | RealtimeCallback,
+		maybeCallback?: RealtimeCallback | string,
+		options?: RealtimeSubscribeOptions,
+	): () => void {
 		if (!this.realtime) {
 			console.warn("[lazypock] No realtime service configured.");
 			return () => {};
 		}
+
+		// Normalise PocketBase-style args; also accept the legacy callback-first
+		// form (subscribe(cb, recordId)) for backward compatibility.
+		let recordId: string | undefined;
+		let callback: RealtimeCallback;
+		let joinPayload: Record<string, unknown> | undefined;
+
+		if (typeof topicOrCallback === "function") {
+			callback = topicOrCallback;
+			if (typeof maybeCallback === "string") recordId = maybeCallback;
+		} else {
+			callback = maybeCallback as RealtimeCallback;
+			recordId = topicOrCallback === "*" ? undefined : topicOrCallback;
+			// Forward subscribe options (minus HTTP-only headers) to the server
+			// channel join payload.
+			const { headers: _ignored, ...rest } = options ?? {};
+			if (Object.keys(rest).length > 0) joinPayload = rest;
+		}
+
 		const topic =
-			"collection:" + this.collectionName + (recordId ? ":" + recordId : "");
+			"collection:" +
+			this.collectionName +
+			(recordId ? ":" + recordId : "");
 		const handler = (raw: RealtimeEventLike) => {
 			const record = (raw.payload?.["record"] ?? {}) as Record<string, unknown>;
 			callback({
@@ -531,17 +589,27 @@ export class CollectionService<T = ApiRecord, TData = never> {
 			});
 		};
 		this.realtime.ensureConnected();
-		this.realtime.subscribe(topic, handler as never);
+		this.realtime.subscribe(topic, handler as never, joinPayload);
 		return () => this.realtime?.unsubscribe(topic, handler as never);
 	}
 
 	/**
-	 * Unsubscribe all callbacks from this collection (or a specific record).
-	 * @param recordId Optional record id; omitting it unsubs everything.
+	 * Unsubscribe from realtime changes (PocketBase-compatible):
+	 *   - `unsubscribe()` — remove **all** subscriptions of this collection
+	 *   - `unsubscribe('*')` — remove wildcard subscriptions
+	 *   - `unsubscribe('RECORD_ID')` — remove that record's subscriptions
 	 */
 	unsubscribe(recordId?: string): void {
+		if (recordId === undefined) {
+			this.realtime?.unsubscribeByPrefix(
+				"collection:" + this.collectionName,
+			);
+			return;
+		}
 		const topic =
-			"collection:" + this.collectionName + (recordId ? ":" + recordId : "");
+			"collection:" +
+			this.collectionName +
+			(recordId === "*" ? "" : ":" + recordId);
 		this.realtime?.unsubscribe(topic);
 	}
 

package/src/index.ts

@@ -56,5 +56,5 @@ export type {
 	LazypockClientOptions,
 } from "./lazypock";
 export type { LazypockCollections } from "./client";
-export type { RealtimeMessage, RealtimeCallback } from "./collection";
+export type { RealtimeMessage, RealtimeCallback, RealtimeSubscribeOptions } from "./collection";
 export type { CollectionsMessage } from "./collections";

package/src/lazypock.ts

@@ -28,6 +28,7 @@ import {
 	type FieldKey,
 } from "./types";
 import { RealtimeService, wsUrlFromBaseUrl } from "./realtime";
+import type { RealtimeConnectOpts, RealtimeTokenProvider } from "./realtime";
 import {
 	FilesService,
 	getFileUrl,
@@ -69,6 +70,9 @@ export type {
 	SystemFields,
 	RequestOptions,
 	FileRecord,
+	// realtime
+	RealtimeConnectOpts,
+	RealtimeTokenProvider,
 	CollectionSchema,
 	SchemaField,
 	// schema-driven query typing
@@ -154,6 +158,12 @@ export class LazypockClient {
 		if (!options.realtime) {
 			this.realtime.setUrl(wsUrlFromBaseUrl(baseUrl));
 		}
+		// Keep the realtime socket authenticated with the current auth token
+		// and reconnect whenever auth changes (login/logout/token refresh) —
+		// PocketBase parity. Reconnect is a no-op until something subscribes.
+		this.realtime.setTokenProvider(() => this.authStore.token);
+		this.authStore.onChange(() => this.realtime.refresh());
+		this.authReady.then(() => this.realtime.refresh());
 		this.files = new FilesService(this.http);
 		this.collections = new CollectionsService(this.http, this.realtime);
 		if (options.types?.schemas) {

package/src/realtime.ts

@@ -16,6 +16,8 @@ interface RealtimeEvent {
 interface SubEntry {
 	topic: string;
 	callback: (e: RealtimeEvent) => void;
+	/** Optional payload forwarded with the channel join (e.g. expand). */
+	joinPayload?: Record<string, unknown>;
 }
 
 export type RealtimeConnectOpts = {
@@ -25,6 +27,13 @@ export type RealtimeConnectOpts = {
 	token?: string;
 };
 
+/**
+ * Provides the current auth token at connect/reconnect time.
+ * Wired by {@link LazypockClient} from its `authStore` so the socket is
+ * always authenticated with the latest token (PocketBase parity).
+ */
+export type RealtimeTokenProvider = () => string | undefined;
+
 /**
  * Derive a WebSocket URL from an HTTP base URL.
  * http://localhost:4000/api → ws://localhost:4000/socket/websocket
@@ -67,6 +76,7 @@ export class RealtimeService {
 
 	private url: string = "";
 	private token: string | undefined;
+	private tokenProvider: RealtimeTokenProvider | null = null;
 
 	/** Whether the WebSocket is currently open. */
 	get isOpen(): boolean {
@@ -94,6 +104,35 @@ export class RealtimeService {
 		this.url = url;
 	}
 
+	/**
+	 * Register a token provider consulted at every (re)connect.
+	 * When set, it takes precedence over the token passed to {@link connect}.
+	 */
+	setTokenProvider(provider: RealtimeTokenProvider): void {
+		this.tokenProvider = provider;
+	}
+
+	/**
+	 * Reconnect the socket immediately with the current token.
+	 * Called by the SDK when auth changes (login/logout/token refresh) so
+	 * private-channel joins are authorized with the new credentials. No-op
+	 * when the socket has never been opened and nothing is subscribed.
+	 */
+	refresh(): void {
+		if (typeof WebSocket === "undefined") return;
+		if (!this.ws && this.subscriptions.size === 0) return;
+		this.clearReconnectTimer();
+		const ws = this.ws;
+		this.ws = null;
+		if (ws) {
+			// Suppress the auto-reconnect path for this intentional close.
+			ws.onclose = null;
+			ws.close();
+		}
+		this.reconnectAttempt = 0;
+		this.doConnect();
+	}
+
 	/*
 	 * Ensure the socket is connected, then subscribe.
 	 * Used by collection-level convenience wrappers so a connection is opened
@@ -120,16 +159,36 @@ export class RealtimeService {
 	}
 
 	/**
-	 * Subscribe to a topic (e.g. "collection:posts" or "collection:posts:*").
+	 * Subscribe to a topic (e.g. "collection:posts" or "custom:chat-room").
 	 * The backend Channel authorizes via listRule on join.
+	 *
+	 * @param joinPayload Optional payload forwarded with the channel join
+	 * (available to the server's join callback / hooks, e.g. `expand`).
 	 */
-	subscribe(topic: string, callback: (e: RealtimeEvent) => void): void {
+	subscribe(
+		topic: string,
+		callback: (e: RealtimeEvent) => void,
+		joinPayload?: Record<string, unknown>,
+	): void {
 		const subs = this.subscriptions.get(topic) || [];
-		subs.push({ topic, callback });
+		subs.push({ topic, callback, joinPayload });
 		this.subscriptions.set(topic, subs);
 
 		if (this.ws?.readyState === WebSocket.OPEN) {
-			this.joinTopic(topic);
+			this.joinTopic(topic, joinPayload);
+		}
+	}
+
+	/**
+	 * Remove all subscriptions for topics under `prefix` (the topic itself or
+	 * any topic starting with `prefix + ":"`). Used by collection-level
+	 * `unsubscribe()` to drop every subscription of a collection.
+	 */
+	unsubscribeByPrefix(prefix: string): void {
+		for (const topic of [...this.subscriptions.keys()]) {
+			if (topic === prefix || topic.startsWith(prefix + ":")) {
+				this.subscriptions.delete(topic);
+			}
 		}
 	}
 
@@ -152,9 +211,14 @@ export class RealtimeService {
 	}
 
 	private resubscribeAll(): void {
-		for (const topic of this.subscriptions.keys()) {
-			if (this.ws?.readyState === WebSocket.OPEN) {
-				this.joinTopic(topic);
+		const seen = new Set<string>();
+		for (const entries of this.subscriptions.values()) {
+			for (const entry of entries) {
+				if (seen.has(entry.topic)) continue;
+				seen.add(entry.topic);
+				if (this.ws?.readyState === WebSocket.OPEN) {
+					this.joinTopic(entry.topic, entry.joinPayload);
+				}
 			}
 		}
 	}
@@ -168,11 +232,12 @@ export class RealtimeService {
 		}
 
 		let url = this.url;
-		if (this.token) {
+		const token = this.tokenProvider ? this.tokenProvider() : this.token;
+		if (token) {
 			url +=
 				(url.includes("?") ? "&" : "?") +
 				"token=" +
-				encodeURIComponent(this.token);
+				encodeURIComponent(token);
 		}
 
 		this.ws = new WebSocket(url);
@@ -232,13 +297,16 @@ export class RealtimeService {
 		}
 	}
 
-	private joinTopic(topic: string): void {
+	private joinTopic(
+		topic: string,
+		joinPayload?: Record<string, unknown>,
+	): void {
 		const ref = this.nextRef();
 		// Phoenix V1 JSON Serializer expects a JSON object, not an array
 		const msg = JSON.stringify({
 			topic: topic,
 			event: "phx_join",
-			payload: {},
+			payload: joinPayload ?? {},
 			ref: ref,
 		});
 		this.ws?.send(msg);

package/dist/chunk-V2XSEOWF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/typegen.ts","../src/codegen.ts"],"sourcesContent":["// ── Type mapping (runtime + codegen) ────────────────────\n// Maps server field types to TypeScript types.\n// Shared by the runtime `SchemaTypes` helper and the codegen CLI.\n\nimport type { SchemaField } from \"./schema\";\n\n/**\n * Map a single server field to its TypeScript type string.\n * Used by the codegen CLI to emit interface members.\n *\n * @param field The field definition.\n * @param fallback Fallback type for unknown field types (default `unknown`).\n */\nexport function fieldTypeScriptType(\n\tfield: SchemaField,\n\tfallback = \"unknown\",\n): string {\n\tconst opts = field.options ?? {};\n\tswitch (field.type) {\n\t\tcase \"text\":\n\t\tcase \"email\":\n\t\tcase \"url\":\n\t\tcase \"editor\":\n\t\tcase \"date\":\n\t\tcase \"datetime\":\n\t\t\treturn \"string\";\n\t\tcase \"number\":\n\t\t\treturn \"number\";\n\t\tcase \"bool\":\n\t\t\treturn \"boolean\";\n\t\tcase \"select\": {\n\t\t\tconst values = Array.isArray(opts.values) ? opts.values : [];\n\t\t\tif (values.length > 0) {\n\t\t\t\treturn values.map((v) => JSON.stringify(String(v))).join(\" | \");\n\t\t\t}\n\t\t\treturn \"string\";\n\t\t}\n\t\tcase \"multi_select\": {\n\t\t\tconst values = Array.isArray(opts.values) ? opts.values : [];\n\t\t\tif (values.length > 0) {\n\t\t\t\treturn `(${values.map((v) => JSON.stringify(String(v))).join(\" | \")})[]`;\n\t\t\t}\n\t\t\treturn \"string[]\";\n\t\t}\n\t\tcase \"file\":\n\t\t\treturn \"string\";\n\t\tcase \"multi_file\":\n\t\t\treturn \"string[]\";\n\t\tcase \"json\":\n\t\tcase \"geo\":\n\t\t\treturn \"Record<string, unknown>\";\n\t\tcase \"relation\":\n\t\t\t// Relations store the target record's ID (string) — or an array\n\t\t\t// of IDs when multi-relation (maxSelect > 1).\n\t\t\treturn (opts.maxSelect ?? 1) > 1 ? \"string[]\" : \"string\";\n\t\tcase \"password\":\n\t\t\t// Passwords are write-only; never expose on read models.\n\t\t\treturn \"never\";\n\t\tdefault:\n\t\t\treturn fallback;\n\t}\n}\n\n/**\n * Returns the runtime type kind for a field — used by {@link schemaFieldType}\n * to build structural types at runtime.\n */\nexport type FieldTypeKind =\n\t| \"string\"\n\t| \"number\"\n\t| \"boolean\"\n\t| \"string-array\"\n\t| \"json\"\n\t| \"relation\"\n\t| \"relation-many\"\n\t| \"password\"\n\t| \"unknown\";\n\n/** Map a server field to its runtime type kind. */\nexport function fieldTypeKind(field: SchemaField): FieldTypeKind {\n\tconst opts = field.options ?? {};\n\tswitch (field.type) {\n\t\tcase \"text\":\n\t\tcase \"email\":\n\t\tcase \"url\":\n\t\tcase \"editor\":\n\t\tcase \"date\":\n\t\tcase \"datetime\":\n\t\tcase \"select\":\n\t\tcase \"file\":\n\t\t\treturn \"string\";\n\t\tcase \"number\":\n\t\t\treturn \"number\";\n\t\tcase \"bool\":\n\t\t\treturn \"boolean\";\n\t\tcase \"multi_select\":\n\t\tcase \"multi_file\":\n\t\t\treturn \"string-array\";\n\t\tcase \"json\":\n\t\tcase \"geo\":\n\t\t\treturn \"json\";\n\t\tcase \"relation\":\n\t\t\treturn (opts.maxSelect ?? 1) > 1 ? \"relation-many\" : \"relation\";\n\t\tcase \"password\":\n\t\t\treturn \"password\";\n\t\tdefault:\n\t\t\treturn \"unknown\";\n\t}\n}\n\n/**\n * Derive a TypeScript field type from a {@link SchemaField} — the runtime\n * counterpart to the codegen mapper. Lets consumers build typed clients\n * from a fetched schema without running the CLI.\n */\nexport function schemaFieldType(field: SchemaField): unknown {\n\tswitch (fieldTypeKind(field)) {\n\t\tcase \"string\":\n\t\t\treturn String;\n\t\tcase \"number\":\n\t\t\treturn Number;\n\t\tcase \"boolean\":\n\t\t\treturn Boolean;\n\t\tcase \"string-array\":\n\t\t\treturn [String] as const;\n\t\tcase \"relation\":\n\t\t\treturn String;\n\t\tcase \"relation-many\":\n\t\t\treturn [String] as const;\n\t\tcase \"json\":\n\t\t\treturn Object;\n\t\tcase \"password\":\n\t\t\treturn undefined;\n\t\tcase \"unknown\":\n\t\t\treturn undefined;\n\t}\n}\n","// ── Codegen ─────────────────────────────────────────────\n// Generates a `lazypock.types.ts` module from the live API schema.\n//\n// The generated file exports:\n//   - One interface per collection (e.g. `PostsRecord`)\n//   - A `LazypockCollections` map: { posts: PostsRecord; users: UsersRecord; ... }\n//   - A `createClient()` factory pre-bound to those types, so\n//     `client.collection(\"posts\").create({ title: \"x\" })` is fully type-checked.\n//\n// The CLI in `src/cli.ts` wires this to `GET /collections`.\n\nimport type { CollectionSchema, SchemaField } from \"./schema\";\nimport { fieldTypeScriptType } from \"./typegen\";\n\n/** Format a raw collection name into a valid TS identifier (PascalCase). */\nexport function collectionTypeName(name: string): string {\n\treturn name\n\t\t.split(/[^a-zA-Z0-9]+/)\n\t\t.filter(Boolean)\n\t\t.map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n\t\t.join(\"\")\n\t\t.replace(/^[0-9]/, \"_$&\");\n}\n\n/** Interface member name — sanitize hyphens/spaces but keep readability. */\nexport function fieldKey(name: string): string {\n\treturn name.replace(/[^a-zA-Z0-9_]/g, \"_\");\n}\n\n\n\n/**\n * Generate the full TypeScript source for the typed SDK module.\n *\n * @param collections Collections fetched from the API.\n * @param options Generation options.\n */\nexport function generateTypes(\n\tcollections: CollectionSchema[],\n\toptions: {\n\t\t/** Import specifier for the lazypock package (default `lazypock`). */\n\t\tpackageName?: string;\n\t\t/** Emit base record fields (id, created, updated, …). Default true. */\n\t\tincludeBaseFields?: boolean;\n\t\t/** Skip system collections (names starting with `_` or `users`). Default false. */\n\t\tskipSystem?: boolean;\n\t} = {},\n): string {\n\tconst {\n\t\tpackageName = \"lazypock\",\n\t\tincludeBaseFields = true,\n\t\tskipSystem = false,\n\t} = options;\n\n\tconst filtered = skipSystem\n\t\t? collections.filter(\n\t\t\t\t(c) => !c.system && !c.name.startsWith(\"_\") && c.name !== \"users\",\n\t\t\t)\n\t\t: collections;\n\n\tconst sections: string[] = [];\n\tsections.push(`// ── Auto-generated by lazypock-ts ──────────────────────────\n// Do not edit by hand. Regenerate with: npx lazypock-gen\n// Schema snapshot: ${new Date().toISOString()}`);\n\n\tif (includeBaseFields) {\n\t\tsections.push(`export interface BaseRecord {\n  id: string;\n  collectionId: string;\n  collectionName: string;\n  created: string;\n  updated: string;\n}`);\n\t}\n\n\t// One interface per collection\n\tfor (const coll of filtered) {\n\t\tconst typeName = collectionTypeName(coll.name);\n\t\tconst fields = coll.fields ?? [];\n\t\tconst lines = fields.map((f) => memberLine(f)).filter((l) => l !== \"\");\n\t\tconst body = lines.join(\"\\n\");\n\t\tsections.push(\n\t\t\t`export interface ${typeName}Record${renderInterface({\n\t\t\t\textends: includeBaseFields ? \"BaseRecord\" : undefined,\n\t\t\t\tbody,\n\t\t\t})}`,\n\t\t);\n\n\t\t// Write-only create data: what `create()`/`update()` accept. This\n\t\t// intentionally includes password fields (and hidden fields) that are\n\t\t// excluded from the read model — the server accepts them on write,\n\t\t// hashes passwords, and never returns them in responses.\n\t\tconst createLines = fields\n\t\t\t.map((f) => createDataMemberLine(f))\n\t\t\t.filter((l) => l !== \"\");\n\t\tsections.push(\n\t\t\t`export interface ${typeName}CreateData${renderInterface({\n\t\t\t\tbody: createLines.join(\"\\n\"),\n\t\t\t})}`,\n\t\t);\n\t}\n\n\t// Auth collection type\n\tsections.push(`export interface AuthRecord extends BaseRecord {\n  email: string;\n  verified: boolean;\n}`);\n\n\t// Collections map\n\tconst mapEntries = filtered\n\t\t.map(\n\t\t\t(c) =>\n\t\t\t\t`  \"${c.name}\": ${collectionTypeName(c.name)}Record${\n\t\t\t\t\tc.type === \"auth\" ? \" & AuthRecord\" : \"\"\n\t\t\t\t};`,\n\t\t)\n\t\t.join(\"\\n\");\n\tsections.push(`export interface LazypockCollections {\n${mapEntries}\n}`);\n\n\t// Create-data map — typed `create()`/`update()` payloads, including\n\t// write-only password fields.\n\tconst createMapEntries = filtered\n\t\t.map((c) => `  \"${c.name}\": ${collectionTypeName(c.name)}CreateData;`)\n\t\t.join(\"\\n\");\n\tsections.push(`export interface LazypockCreateData {\n${createMapEntries}\n}`);\n\n\t// Runtime schema snapshot — lets the client exclude hidden fields by\n\t// default, validate select/expand, and derive visible field lists.\n\tconst schemaEntries = collections\n\t\t.map(\n\t\t\t(c) =>\n\t\t\t\t`  {\n    id: ${JSON.stringify(c.id ?? null)},\n    name: ${JSON.stringify(c.name)},\n    type: ${JSON.stringify(c.type)},\n    system: ${JSON.stringify(c.system ?? false)},\n    fields: ${JSON.stringify(c.fields ?? [], null, 2)},\n    rules: ${JSON.stringify(c.rules ?? {})},\n    options: ${JSON.stringify(c.options ?? {})},\n  }`,\n\t\t)\n\t\t.join(\",\\n\");\n\tsections.push(`// Schema snapshot (runtime) — hidden-field exclusion + query validation.\nexport const lazypockSchema: import(\"${packageName}\").CollectionSchema[] = [\n${schemaEntries}\n];`);\n\n\t// createClient factory\n\tsections.push(`import { LazypockClient, type LazypockClientOptions, type CollectionService } from \"${packageName}\";\n\n/**\n * Create a Lazypock client typed against this schema snapshot.\n * Collection access is fully type-checked:\n *   client.collection(\"posts\").create({ title: \"x\" }) // title must exist\n *\n * For auth collections the generated *CreateData type includes the\n * write-only password field, so creating a user is type-safe:\n *   client.collection(\"users\").create({ email, password }) // ✓\n *\n * The schema snapshot is wired into the client automatically, so hidden\n * fields are excluded from responses and select/expand are validated.\n */\nexport function createClient(options: LazypockClientOptions): TypedClient {\n  return new TypedClient({\n    ...options,\n    types: {\n      ...options.types,\n      schemas: options.types?.schemas ?? lazypockSchema,\n    },\n  });\n}\n\nexport class TypedClient extends LazypockClient {\n  // K extends keyof LazypockCollections (rather than a generic string with a\n  // conditional return) so the IDE suggests collection names and unknown names\n  // are rejected at compile time:\n  //   client.collection(\"posts\")  // suggested + typed\n  //   client.collection(\"nope\")   // TS error\n  //\n  // create()/update() take the collection's *CreateData — the read model\n  // omits password/hidden fields, but the write model carries them.\n  // T extends string (rather than keyof LazypockCollections) with a conditional\n  // return type, so the IDE suggests collection names AND unknown/dynamic names\n  // still resolve to the untyped service — a studio that manages\n  // user-created collections must be able to call collection(someString).\n  //\n  // create()/update() take the collection's *CreateData — the read model\n  // omits password/hidden fields, but the write model carries them.\n  override collection<T extends string>(name: T): T extends keyof LazypockCollections\n    ? CollectionService<LazypockCollections[T], LazypockCreateData[T]>\n    : CollectionService<unknown> {\n    return super.collection(name) as T extends keyof LazypockCollections\n      ? CollectionService<LazypockCollections[T], LazypockCreateData[T]>\n      : CollectionService<unknown>;\n  }\n}\n`);\n\n\treturn sections.join(\"\\n\\n\") + \"\\n\";\n}\n\n/**\n * Render the interface body including the extends clause.\n * Empty body → ` extends BaseRecord {}` (valid TS).\n */\nfunction renderInterface(opts: { extends?: string; body: string }): string {\n\tconst ext = opts.extends ? ` extends ${opts.extends}` : \"\";\n\tif (!opts.body) return `${ext} {}`;\n\treturn `${ext} {\\n${opts.body}\\n}`;\n}\n\n/** Render a single interface member line for a field. */\nfunction memberLine(f: SchemaField): string {\n\t// Hidden fields are excluded from API responses by the schema-aware\n\t// client default — don't expose them on the read model either.\n\tif (f.hidden) return \"\";\n\tconst key = fieldKey(f.name);\n\tconst req = f.required || f.type === \"password\" ? \"\" : \"?\";\n\tconst type = fieldTypeScriptType(f);\n\t// `never` members (passwords) are omitted from read models.\n\tif (type === \"never\") return \"\";\n\treturn `  ${JSON.stringify(key)}${req}: ${type};`;\n}\n\n/**\n * Render a write-only create-data member for a field.\n *\n * Unlike the read model, create/update data includes password fields (sent as\n * plain strings — the server hashes them) and hidden fields: the server\n * accepts them on write and never returns them in responses.\n *\n * A field is only marked required when it actually needs a client value:\n * fields with a server-side default (`options.defaultValue`) and the auth\n * system fields `verified` / `emailVisibility` (the server defaults them to\n * false/true even though the snapshot doesn't carry `defaultValue`) stay\n * optional, so `create({ email, password_hash })` typechecks without forcing\n * callers to send values the server would fill in anyway.\n */\nfunction createDataMemberLine(f: SchemaField): string {\n\t// Autodate columns are server-managed; never writable.\n\tif (f.type === \"autodate\") return \"\";\n\tconst key = fieldKey(f.name);\n\tconst serverDefaulted =\n\t\tf.options?.defaultValue !== undefined ||\n\t\t(f.system && (f.name === \"verified\" || f.name === \"emailVisibility\"));\n\tconst req = f.required && !serverDefaulted ? \"\" : \"?\";\n\tconst type = f.type === \"password\" ? \"string\" : fieldTypeScriptType(f);\n\tif (type === \"never\") return \"\";\n\treturn `  ${JSON.stringify(key)}${req}: ${type};`;\n}\n"],"mappings":"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","names":[]}