lazypock 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -413,6 +413,8 @@ interface SchemaField {
     id?: string;
     name: string;
     type: string;
+    /** For relation fields: the target collection id (server-resolved). */
+    collectionId?: string | null;
     required?: boolean;
     unique?: boolean;
     options?: {
@@ -465,8 +467,9 @@ declare class CollectionService<T = ApiRecord> {
     private schema?;
     /**
      * Active field projection from {@link select}. `"*"` (or unset) means
-     * "all visible (non-hidden) fields" — resolved against the schema when
-     * one is available, otherwise left to the server.
+     * "all visible (non-hidden) fields plus the implicit system keys" —
+     * resolved against the schema when one is available, otherwise left to
+     * the server.
      */
     private fieldsPreset?;
     /** @internal */
@@ -484,9 +487,10 @@ declare class CollectionService<T = ApiRecord> {
      * const t = await client.collection("posts").select("id", "title").getList();
      * // GET /api/posts?fields=id,title
      *
-     * // All visible fields (hidden fields are excluded server-side)
+     * // All visible fields (implicit system keys id/created/updated/… are
+     * // kept; hidden fields are excluded via the projection)
      * const all = await client.collection("posts").select("*").getList();
-     * // GET /api/posts?fields=id,title,published,… (schema known)
+     * // GET /api/posts?fields=id,created,updated,collectionId,collectionName,title,published,… (schema known)
      * ```
      *
      * When no schema is known, the default (no `select()` call) sends no
@@ -498,12 +502,23 @@ declare class CollectionService<T = ApiRecord> {
      * Fields to send with reads:
      * 1. explicit `options.fields` (caller wins)
      * 2. `select()` preset
-     * 3. schema default — all visible (non-hidden, non-system) fields
+     * 3. schema default — all visible (non-hidden) fields plus the implicit
+     *    system keys (`id`, `created`, `updated`, `collectionId`, `collectionName`)
      */
     private effectiveFields;
     /**
-     * All non-hidden, non-system, non-password field names from the schema.
-     * `undefined` when no schema is available (server decides).
+     * All non-hidden, non-password, non-autodate field names from the schema,
+     * prefixed with the implicit system keys that are part of every record
+     * (`id`, `created`, `updated`, `collectionId`, `collectionName`).
+     *
+     * The system keys never appear in the schema (they are implied for every
+     * collection) but MUST be listed explicitly when projecting — the server
+     * applies strict projection, so unrequested fields are dropped. Without
+     * them, `getList`/`getOne` responses lose `id` (and `created`/`updated`),
+     * breaking selection, edits, and relation references.
+     *
+     * `undefined` when no schema fields are available (server decides — its
+     * default returns every non-password field, including the system keys).
      */
     visibleFields(): string | undefined;
     /** Warn once when an expand field is not a relation (schema known). */
@@ -865,6 +880,14 @@ interface LazypockClientOptions {
 declare class LazypockClient {
     readonly http: HttpClient;
     readonly authStore: AuthStore;
+    /**
+     * Resolves once persisted auth state has been loaded from storage.
+     * The client auto-initializes its auth store on construction, so a
+     * previously persisted token is ready immediately (no manual
+     * `authStore.init()` needed). Await this only if you must gate on
+     * the restored session.
+     */
+    readonly authReady: Promise<void>;
     readonly realtime: RealtimeService;
     readonly collections: CollectionsService;
     readonly files: FilesService;

package/dist/index.d.ts

@@ -413,6 +413,8 @@ interface SchemaField {
     id?: string;
     name: string;
     type: string;
+    /** For relation fields: the target collection id (server-resolved). */
+    collectionId?: string | null;
     required?: boolean;
     unique?: boolean;
     options?: {
@@ -465,8 +467,9 @@ declare class CollectionService<T = ApiRecord> {
     private schema?;
     /**
      * Active field projection from {@link select}. `"*"` (or unset) means
-     * "all visible (non-hidden) fields" — resolved against the schema when
-     * one is available, otherwise left to the server.
+     * "all visible (non-hidden) fields plus the implicit system keys" —
+     * resolved against the schema when one is available, otherwise left to
+     * the server.
      */
     private fieldsPreset?;
     /** @internal */
@@ -484,9 +487,10 @@ declare class CollectionService<T = ApiRecord> {
      * const t = await client.collection("posts").select("id", "title").getList();
      * // GET /api/posts?fields=id,title
      *
-     * // All visible fields (hidden fields are excluded server-side)
+     * // All visible fields (implicit system keys id/created/updated/… are
+     * // kept; hidden fields are excluded via the projection)
      * const all = await client.collection("posts").select("*").getList();
-     * // GET /api/posts?fields=id,title,published,… (schema known)
+     * // GET /api/posts?fields=id,created,updated,collectionId,collectionName,title,published,… (schema known)
      * ```
      *
      * When no schema is known, the default (no `select()` call) sends no
@@ -498,12 +502,23 @@ declare class CollectionService<T = ApiRecord> {
      * Fields to send with reads:
      * 1. explicit `options.fields` (caller wins)
      * 2. `select()` preset
-     * 3. schema default — all visible (non-hidden, non-system) fields
+     * 3. schema default — all visible (non-hidden) fields plus the implicit
+     *    system keys (`id`, `created`, `updated`, `collectionId`, `collectionName`)
      */
     private effectiveFields;
     /**
-     * All non-hidden, non-system, non-password field names from the schema.
-     * `undefined` when no schema is available (server decides).
+     * All non-hidden, non-password, non-autodate field names from the schema,
+     * prefixed with the implicit system keys that are part of every record
+     * (`id`, `created`, `updated`, `collectionId`, `collectionName`).
+     *
+     * The system keys never appear in the schema (they are implied for every
+     * collection) but MUST be listed explicitly when projecting — the server
+     * applies strict projection, so unrequested fields are dropped. Without
+     * them, `getList`/`getOne` responses lose `id` (and `created`/`updated`),
+     * breaking selection, edits, and relation references.
+     *
+     * `undefined` when no schema fields are available (server decides — its
+     * default returns every non-password field, including the system keys).
      */
     visibleFields(): string | undefined;
     /** Warn once when an expand field is not a relation (schema known). */
@@ -865,6 +880,14 @@ interface LazypockClientOptions {
 declare class LazypockClient {
     readonly http: HttpClient;
     readonly authStore: AuthStore;
+    /**
+     * Resolves once persisted auth state has been loaded from storage.
+     * The client auto-initializes its auth store on construction, so a
+     * previously persisted token is ready immediately (no manual
+     * `authStore.init()` needed). Await this only if you must gate on
+     * the restored session.
+     */
+    readonly authReady: Promise<void>;
     readonly realtime: RealtimeService;
     readonly collections: CollectionsService;
     readonly files: FilesService;

package/dist/index.global.js

@@ -519,9 +519,10 @@ var Lazypock = (() => {
      * const t = await client.collection("posts").select("id", "title").getList();
      * // GET /api/posts?fields=id,title
      *
-     * // All visible fields (hidden fields are excluded server-side)
+     * // All visible fields (implicit system keys id/created/updated/… are
+     * // kept; hidden fields are excluded via the projection)
      * const all = await client.collection("posts").select("*").getList();
-     * // GET /api/posts?fields=id,title,published,… (schema known)
+     * // GET /api/posts?fields=id,created,updated,collectionId,collectionName,title,published,… (schema known)
      * ```
      *
      * When no schema is known, the default (no `select()` call) sends no
@@ -554,7 +555,8 @@ var Lazypock = (() => {
      * Fields to send with reads:
      * 1. explicit `options.fields` (caller wins)
      * 2. `select()` preset
-     * 3. schema default — all visible (non-hidden, non-system) fields
+     * 3. schema default — all visible (non-hidden) fields plus the implicit
+     *    system keys (`id`, `created`, `updated`, `collectionId`, `collectionName`)
      */
     effectiveFields(optionsFields) {
       if (optionsFields !== void 0) return optionsFields;
@@ -567,15 +569,35 @@ var Lazypock = (() => {
       return this.visibleFields();
     }
     /**
-     * All non-hidden, non-system, non-password field names from the schema.
-     * `undefined` when no schema is available (server decides).
+     * All non-hidden, non-password, non-autodate field names from the schema,
+     * prefixed with the implicit system keys that are part of every record
+     * (`id`, `created`, `updated`, `collectionId`, `collectionName`).
+     *
+     * The system keys never appear in the schema (they are implied for every
+     * collection) but MUST be listed explicitly when projecting — the server
+     * applies strict projection, so unrequested fields are dropped. Without
+     * them, `getList`/`getOne` responses lose `id` (and `created`/`updated`),
+     * breaking selection, edits, and relation references.
+     *
+     * `undefined` when no schema fields are available (server decides — its
+     * default returns every non-password field, including the system keys).
      */
     visibleFields() {
       if (!this.schema?.fields) return void 0;
       const visible = this.schema.fields.filter(
         (f) => !f.hidden && f.type !== "password" && f.type !== "autodate"
       ).map((f) => f.name);
-      return visible.length > 0 ? visible.join(",") : void 0;
+      if (visible.length === 0) return void 0;
+      return [
+        .../* @__PURE__ */ new Set([
+          "id",
+          "created",
+          "updated",
+          "collectionId",
+          "collectionName",
+          ...visible
+        ])
+      ].join(",");
     }
     /** Warn once when an expand field is not a relation (schema known). */
     validateExpand(expand) {
@@ -1508,10 +1530,13 @@ export function createClient(options: LazypockClientOptions): TypedClient {
 }
 
 export class TypedClient extends LazypockClient {
-  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>;
+  // K extends keyof LazypockCollections (rather than a generic string with a
+  // conditional return) so the IDE suggests collection names and unknown names
+  // are rejected at compile time:
+  //   client.collection("posts")  // suggested + typed
+  //   client.collection("nope")   // TS error
+  override collection<K extends keyof LazypockCollections>(name: K): CollectionService<LazypockCollections[K]> {
+    return super.collection(name) as CollectionService<LazypockCollections[K]>;
   }
 }
 `);
@@ -1543,6 +1568,7 @@ ${opts.body}
       this.collectionCache = /* @__PURE__ */ new Map();
       const baseUrl = options.baseUrl.replace(/\/+$/, "");
       this.authStore = options.authStore ?? new AuthStore(options.storage ?? memoryStorage);
+      this.authReady = options.authStore ? Promise.resolve() : this.authStore.init();
       this.http = new HttpClient(baseUrl, this.authStore);
       this.realtime = options.realtime ?? new RealtimeService();
       if (!options.realtime) {