@zuzjs/flare 0.2.20 → 0.2.22

package/README.md

@@ -48,6 +48,51 @@ const same = getFlare();
 disconnectFlare();
 ```
 
+### Bulk Writes (Memory Efficient)
+
+`addMany`, `updateMany`, and `deleteMany` process data in bounded chunks so very large input streams can run without loading everything into memory at once.
+
+```ts
+const users = app.collection<{ name: string; plan?: string }>('users');
+
+// Add many from an array
+const addResult = await users.addMany(
+  [{ name: 'Alice' }, { name: 'Bob' }],
+  {
+    batchSize: 500,
+    concurrency: 8,
+    onProgress: (p) => {
+      console.log('addMany', p.processed, p.total, p.percent);
+    },
+  },
+);
+
+// Update many by id
+const updateResult = await users.updateMany(
+  [
+    { id: 'user_1', data: { plan: 'pro' } },
+    { id: 'user_2', data: { plan: 'team' } },
+  ],
+  { continueOnError: true },
+);
+
+// Delete many by id
+const deleteResult = await users.deleteMany(['user_3', 'user_4']);
+
+console.log({ addResult, updateResult, deleteResult });
+```
+
+```ts
+// Stream input from an async source (best for huge datasets)
+async function* rows() {
+  for (let i = 0; i < 1_000_000; i += 1) {
+    yield { name: `user-${i}` };
+  }
+}
+
+await app.collection('users').addMany(rows(), { batchSize: 1000, concurrency: 4 });
+```
+
 ### Auth Config And State
 
 ```ts
@@ -548,6 +593,10 @@ const uploaded = await storage.putObject({
   },
 });
 
+console.log(uploaded.key);    // users/alice.png
+console.log(uploaded.access); // public (default)
+console.log(uploaded.url);    // https://.../storage/public/<appId>/avatars/users%2Falice.png
+
 // ── Base64 upload (opt-in, small files only) ─────────────────────────────────
 // Pass `base64: true` to use the legacy base64-over-JSON path.
 // If the payload exceeds `base64MaxBytes` (default 4 MiB), the SDK
@@ -557,6 +606,7 @@ const uploaded2 = await storage.putObject({
   key: 'users/thumb.png',
   body: smallFileBytes,
   contentType: 'image/png',
+  access: 'private',   // override the default public access
   base64: true,         // prefer base64 path
   base64MaxBytes: 2 * 1024 * 1024, // cap at 2 MiB; larger → raw upload
 });
@@ -567,12 +617,17 @@ const uploaded3 = await storage.putObject({
   key: 'users/icon.png',
   contentBase64: alreadyEncodedString,
   contentType: 'image/png',
+  // encrypt defaults to false when omitted
 });
 
 const head = await storage.headObject({ bucket: 'avatars', key: uploaded.key });
+console.log(head.access, head.url);
+
 const file = await storage.getObject({ bucket: 'avatars', key: uploaded.key });
 
 const page1 = await storage.listObjects({ bucket: 'avatars', prefix: 'users/', limit: 100 });
+console.log(page1.objects[0]?.access, page1.objects[0]?.url);
+
 const page2 = page1.cursor
   ? await storage.listObjects({ bucket: 'avatars', prefix: 'users/', limit: 100, cursor: page1.cursor })
   : { objects: [] };
@@ -595,6 +650,7 @@ const signedUpload = await storage.createSignedUrl({
   action: FlareStorageSignedAction.Upload,
   expiresInSeconds: 300,
   contentType: 'video/mp4',
+  access: 'private',
   encrypt: true,
 });
 
@@ -678,6 +734,9 @@ const embedUrl = await storage.getObjectUrl({
 ```
 
 Notes:
+- `putObject()` defaults to `encrypt: false` and `access: 'public'`.
+- `uploaded.url` is the stable public object URL shape. Anonymous reads still depend on stored `access` and any storage rules configured on the app.
+- `headObject()` and `listObjects()` also return `access` and `url` metadata.
 - `forceDownload` and `embedOnly` are mutually exclusive.
 - `allowedOrigins` defaults to `['*']` when omitted.
 - `embedOnly` is valid only for download signed URLs.

package/dist/grpc.d.cts

@@ -1,4 +1,4 @@
-import { F as FlareConfig, aN as StructuredQuery } from './index-Y0Mq_6P9.cjs';
+import { F as FlareConfig, aR as StructuredQuery } from './index-18tMqAtM.cjs';
 import '@zuzjs/auth';
 
 declare function runGrpcQuery<T = Record<string, unknown>>(config: FlareConfig, collection: string, query: StructuredQuery): Promise<T[] | null>;

package/dist/grpc.d.ts

@@ -1,4 +1,4 @@
-import { F as FlareConfig, aN as StructuredQuery } from './index-Y0Mq_6P9.js';
+import { F as FlareConfig, aR as StructuredQuery } from './index-18tMqAtM.js';
 import '@zuzjs/auth';
 
 declare function runGrpcQuery<T = Record<string, unknown>>(config: FlareConfig, collection: string, query: StructuredQuery): Promise<T[] | null>;

package/dist/{index-Y0Mq_6P9.d.cts → index-18tMqAtM.d.cts}

@@ -264,6 +264,8 @@ interface FlareStorageObjectResult {
     ok: boolean;
     path: string;
     key: string;
+    access?: "public" | "private";
+    url?: string;
     encrypted?: boolean;
     size?: number;
     contentBase64?: string;
@@ -282,6 +284,7 @@ interface FlareStorageSignedUrlInput {
     expiresInSeconds?: number;
     sizeBytes?: number;
     contentType?: string;
+    access?: "public" | "private";
     encrypt?: boolean;
     decrypt?: boolean;
     forceDownload?: boolean;
@@ -370,6 +373,8 @@ interface StorageObjectMeta {
     bucket: string;
     size: number;
     contentType: string;
+    access?: "public" | "private";
+    url?: string;
     encrypted: boolean;
     createdAt?: unknown;
     updatedAt?: unknown;
@@ -402,7 +407,9 @@ interface PutObjectInput {
      */
     base64MaxBytes?: number;
     contentType?: string;
-    /** Encrypt at rest with AES-256-GCM. Defaults to true. */
+    /** Public/private object access. Defaults to public. */
+    access?: "public" | "private";
+    /** Encrypt at rest with AES-256-GCM. Defaults to false. */
     encrypt?: boolean;
     /** Upload progress callback. Only fires in browser environments. */
     onProgress?: (progress: StorageProgress) => void;
@@ -411,6 +418,8 @@ interface PutObjectResult {
     ok: boolean;
     bucket: string;
     key: string;
+    access: "public" | "private";
+    url?: string;
     size: number;
     encrypted: boolean;
 }
@@ -503,6 +512,7 @@ interface StorageSignedUrlInput {
     expiresInSeconds?: number;
     sizeBytes?: number;
     contentType?: string;
+    access?: "public" | "private";
     encrypt?: boolean;
     decrypt?: boolean;
     forceDownload?: boolean;
@@ -732,6 +742,40 @@ type DocAddedCallback<T = any> = (data: T, docId: string) => void;
 type DocUpdatedCallback<T = any> = (data: T, docId: string) => void;
 type DocDeletedCallback<T = any> = (docId: string) => void;
 type DocChangedCallback<T = any> = (data: T | null, docId: string, operation: ChangeOperation) => void;
+type BulkWriteOperation = 'addMany' | 'updateMany' | 'deleteMany';
+interface BulkWriteProgress {
+    operation: BulkWriteOperation;
+    processed: number;
+    succeeded: number;
+    failed: number;
+    total?: number;
+    percent?: number;
+    lastDocId?: string;
+    lastError?: unknown;
+}
+interface BulkWriteResult {
+    operation: BulkWriteOperation;
+    processed: number;
+    succeeded: number;
+    failed: number;
+    total?: number;
+}
+interface BulkWriteOptions {
+    /** How many operations to execute per chunk; defaults to 250. */
+    batchSize?: number;
+    /** Number of in-flight writes within each chunk; defaults to 1. */
+    concurrency?: number;
+    /** Continue processing remaining items after individual failures. */
+    continueOnError?: boolean;
+    /** Optional cancellation signal for long-running bulk writes. */
+    signal?: AbortSignal;
+    /** Progress callback invoked after each processed item. */
+    onProgress?: (progress: BulkWriteProgress) => void;
+}
+interface UpdateManyItem<T = any> {
+    id: string;
+    data: Partial<T>;
+}
 type StreamFlushReason = 'snapshot' | 'change-batch';
 interface CollectionStreamOptions<T = any> {
     /** Delay before a queued burst is flushed to listeners. */
@@ -862,4 +906,4 @@ type SecurityRulesMap = Record<string, SecurityRuleEntry>;
 declare const flareRulesToSecurityMap: (rules: FlareRule[]) => SecurityRulesMap;
 declare const securityMapToFlareRules: (rules: SecurityRulesMap) => FlareRule[];
 
-export { type FlareStorageServerInput as $, type AggregateFunction as A, type BrowserPushRegistrationOptions as B, type ChangeEvent as C, type DataMapperFn as D, type DocUpdatedCallback as E, type FlareConfig as F, type DocumentSnapshot as G, type DownloadObjectInput as H, type DownloadObjectResult as I, type EmailLinkVerifyResult as J, type EmailSendResult as K, type FlareAuthConfig as L, type FlareAuthHydrationInput as M, type FlareAuthHydrationOptions as N, type FlareAuthProviderId as O, type FlareAuthProviderPublicConfig as P, type FlareAuthSession as Q, type FlareAuthUser as R, type FlareRule as S, type FlareStorageAutoConfig as T, type FlareStorageAwsConfig as U, type FlareStorageDeleteInput as V, type FlareStorageDownloadInput as W, type FlareStorageObjectResult as X, type FlareStorageRulesHistoryResult as Y, type FlareStorageRulesPolicy as Z, type FlareStorageServer as _, type AggregateSpec as a, type FlareStorageServerPatchInput as a0, FlareStorageSignedAction as a1, type FlareStorageSignedUrlInput as a2, type FlareStorageSignedUrlResult as a3, type FlareStorageTransferManagerConfig as a4, type FlareStorageUploadInput as a5, type GetObjectInput as a6, type GetObjectResult as a7, type GetObjectUrlInput as a8, type GroupByClause as a9, type RulePermission as aA, type SecurityRuleEntry as aB, type SecurityRulesMap as aC, type SendEmailInput as aD, type SendPushNotificationInput as aE, type SnapshotEvent as aF, type StorageBucket as aG, type StorageBucketInput as aH, type StorageObjectMeta as aI, type StorageProgress as aJ, type StorageSignedUrlInput as aK, type StreamFlushReason as aL, type StructuredJoinClause as aM, type StructuredQuery as aN, type SubscribeOptions as aO, type SubscriptionCallback as aP, type SubscriptionData as aQ, type SubscriptionError as aR, type SubscriptionErrorCallback as aS, type SubscriptionHandle as aT, type VectorFieldConfig as aU, type VectorSearchClause as aV, type VerifyEmailLinkInput as aW, type WhereCondition as aX, flareRulesToSecurityMap as aY, securityMapToFlareRules as aZ, type HavingClause as aa, type HeadObjectInput as ab, type HeadObjectsInput as ac, type JoinClause as ad, type JoinQueryPattern as ae, type ListObjectsInput as af, type ListObjectsResult as ag, type NestedJoinClause as ah, type OfflineOperation as ai, type OrFilter as aj, type OrderByClause as ak, type PresenceCallback as al, type PresenceJoinCallback as am, type PresenceLeaveCallback as an, type PresenceMember as ao, type PushSendResult as ap, type PutObjectInput as aq, type PutObjectResult as ar, type QueryConfig as as, type QueryOperator as at, type QueryPresetMap as au, type QueryPresetParams as av, type QueryPresetRow as aw, type QueryPresetSpec as ax, type QuerySnapshot as ay, type RegisterPushTokenInput as az, type AndFilter as b, type AnyFilter as c, type AuthConfigListener as d, type AuthResult as e, type AuthStateListener as f, type AuthWithPendingVerificationResult as g, type AuthWithTokenResult as h, type BrowserPushTokenOptions as i, type BucketCorsRule as j, type BucketPolicyInput as k, type ChangeOperation as l, type CollectionExternalStore as m, type CollectionStream as n, type CollectionStreamListener as o, type CollectionStreamMeta as p, type CollectionStreamOptions as q, type ConnectionState as r, type CopyObjectInput as s, type CursorValue as t, type DataMapperRegistry as u, type DeleteObjectInput as v, type DeleteObjectsInput as w, type DocAddedCallback as x, type DocChangedCallback as y, type DocDeletedCallback as z };
+export { type FlareStorageObjectResult as $, type AggregateFunction as A, type BrowserPushRegistrationOptions as B, type ChangeEvent as C, type DataMapperFn as D, type DeleteObjectsInput as E, type FlareConfig as F, type DocAddedCallback as G, type DocChangedCallback as H, type DocDeletedCallback as I, type DocUpdatedCallback as J, type DocumentSnapshot as K, type DownloadObjectInput as L, type DownloadObjectResult as M, type EmailLinkVerifyResult as N, type EmailSendResult as O, type FlareAuthConfig as P, type FlareAuthHydrationInput as Q, type FlareAuthHydrationOptions as R, type FlareAuthProviderId as S, type FlareAuthProviderPublicConfig as T, type FlareAuthSession as U, type FlareAuthUser as V, type FlareRule as W, type FlareStorageAutoConfig as X, type FlareStorageAwsConfig as Y, type FlareStorageDeleteInput as Z, type FlareStorageDownloadInput as _, type AggregateSpec as a, type VerifyEmailLinkInput as a$, type FlareStorageRulesHistoryResult as a0, type FlareStorageRulesPolicy as a1, type FlareStorageServer as a2, type FlareStorageServerInput as a3, type FlareStorageServerPatchInput as a4, FlareStorageSignedAction as a5, type FlareStorageSignedUrlInput as a6, type FlareStorageSignedUrlResult as a7, type FlareStorageTransferManagerConfig as a8, type FlareStorageUploadInput as a9, type QueryPresetRow as aA, type QueryPresetSpec as aB, type QuerySnapshot as aC, type RegisterPushTokenInput as aD, type RulePermission as aE, type SecurityRuleEntry as aF, type SecurityRulesMap as aG, type SendEmailInput as aH, type SendPushNotificationInput as aI, type SnapshotEvent as aJ, type StorageBucket as aK, type StorageBucketInput as aL, type StorageObjectMeta as aM, type StorageProgress as aN, type StorageSignedUrlInput as aO, type StreamFlushReason as aP, type StructuredJoinClause as aQ, type StructuredQuery as aR, type SubscribeOptions as aS, type SubscriptionCallback as aT, type SubscriptionData as aU, type SubscriptionError as aV, type SubscriptionErrorCallback as aW, type SubscriptionHandle as aX, type UpdateManyItem as aY, type VectorFieldConfig as aZ, type VectorSearchClause as a_, type GetObjectInput as aa, type GetObjectResult as ab, type GetObjectUrlInput as ac, type GroupByClause as ad, type HavingClause as ae, type HeadObjectInput as af, type HeadObjectsInput as ag, type JoinClause as ah, type JoinQueryPattern as ai, type ListObjectsInput as aj, type ListObjectsResult as ak, type NestedJoinClause as al, type OfflineOperation as am, type OrFilter as an, type OrderByClause as ao, type PresenceCallback as ap, type PresenceJoinCallback as aq, type PresenceLeaveCallback as ar, type PresenceMember as as, type PushSendResult as at, type PutObjectInput as au, type PutObjectResult as av, type QueryConfig as aw, type QueryOperator as ax, type QueryPresetMap as ay, type QueryPresetParams as az, type AndFilter as b, type WhereCondition as b0, flareRulesToSecurityMap as b1, securityMapToFlareRules as b2, type AnyFilter as c, type AuthConfigListener as d, type AuthResult as e, type AuthStateListener as f, type AuthWithPendingVerificationResult as g, type AuthWithTokenResult as h, type BrowserPushTokenOptions as i, type BucketCorsRule as j, type BucketPolicyInput as k, type BulkWriteOperation as l, type BulkWriteOptions as m, type BulkWriteProgress as n, type BulkWriteResult as o, type ChangeOperation as p, type CollectionExternalStore as q, type CollectionStream as r, type CollectionStreamListener as s, type CollectionStreamMeta as t, type CollectionStreamOptions as u, type ConnectionState as v, type CopyObjectInput as w, type CursorValue as x, type DataMapperRegistry as y, type DeleteObjectInput as z };

package/dist/{index-Y0Mq_6P9.d.ts → index-18tMqAtM.d.ts}

@@ -264,6 +264,8 @@ interface FlareStorageObjectResult {
     ok: boolean;
     path: string;
     key: string;
+    access?: "public" | "private";
+    url?: string;
     encrypted?: boolean;
     size?: number;
     contentBase64?: string;
@@ -282,6 +284,7 @@ interface FlareStorageSignedUrlInput {
     expiresInSeconds?: number;
     sizeBytes?: number;
     contentType?: string;
+    access?: "public" | "private";
     encrypt?: boolean;
     decrypt?: boolean;
     forceDownload?: boolean;
@@ -370,6 +373,8 @@ interface StorageObjectMeta {
     bucket: string;
     size: number;
     contentType: string;
+    access?: "public" | "private";
+    url?: string;
     encrypted: boolean;
     createdAt?: unknown;
     updatedAt?: unknown;
@@ -402,7 +407,9 @@ interface PutObjectInput {
      */
     base64MaxBytes?: number;
     contentType?: string;
-    /** Encrypt at rest with AES-256-GCM. Defaults to true. */
+    /** Public/private object access. Defaults to public. */
+    access?: "public" | "private";
+    /** Encrypt at rest with AES-256-GCM. Defaults to false. */
     encrypt?: boolean;
     /** Upload progress callback. Only fires in browser environments. */
     onProgress?: (progress: StorageProgress) => void;
@@ -411,6 +418,8 @@ interface PutObjectResult {
     ok: boolean;
     bucket: string;
     key: string;
+    access: "public" | "private";
+    url?: string;
     size: number;
     encrypted: boolean;
 }
@@ -503,6 +512,7 @@ interface StorageSignedUrlInput {
     expiresInSeconds?: number;
     sizeBytes?: number;
     contentType?: string;
+    access?: "public" | "private";
     encrypt?: boolean;
     decrypt?: boolean;
     forceDownload?: boolean;
@@ -732,6 +742,40 @@ type DocAddedCallback<T = any> = (data: T, docId: string) => void;
 type DocUpdatedCallback<T = any> = (data: T, docId: string) => void;
 type DocDeletedCallback<T = any> = (docId: string) => void;
 type DocChangedCallback<T = any> = (data: T | null, docId: string, operation: ChangeOperation) => void;
+type BulkWriteOperation = 'addMany' | 'updateMany' | 'deleteMany';
+interface BulkWriteProgress {
+    operation: BulkWriteOperation;
+    processed: number;
+    succeeded: number;
+    failed: number;
+    total?: number;
+    percent?: number;
+    lastDocId?: string;
+    lastError?: unknown;
+}
+interface BulkWriteResult {
+    operation: BulkWriteOperation;
+    processed: number;
+    succeeded: number;
+    failed: number;
+    total?: number;
+}
+interface BulkWriteOptions {
+    /** How many operations to execute per chunk; defaults to 250. */
+    batchSize?: number;
+    /** Number of in-flight writes within each chunk; defaults to 1. */
+    concurrency?: number;
+    /** Continue processing remaining items after individual failures. */
+    continueOnError?: boolean;
+    /** Optional cancellation signal for long-running bulk writes. */
+    signal?: AbortSignal;
+    /** Progress callback invoked after each processed item. */
+    onProgress?: (progress: BulkWriteProgress) => void;
+}
+interface UpdateManyItem<T = any> {
+    id: string;
+    data: Partial<T>;
+}
 type StreamFlushReason = 'snapshot' | 'change-batch';
 interface CollectionStreamOptions<T = any> {
     /** Delay before a queued burst is flushed to listeners. */
@@ -862,4 +906,4 @@ type SecurityRulesMap = Record<string, SecurityRuleEntry>;
 declare const flareRulesToSecurityMap: (rules: FlareRule[]) => SecurityRulesMap;
 declare const securityMapToFlareRules: (rules: SecurityRulesMap) => FlareRule[];
 
-export { type FlareStorageServerInput as $, type AggregateFunction as A, type BrowserPushRegistrationOptions as B, type ChangeEvent as C, type DataMapperFn as D, type DocUpdatedCallback as E, type FlareConfig as F, type DocumentSnapshot as G, type DownloadObjectInput as H, type DownloadObjectResult as I, type EmailLinkVerifyResult as J, type EmailSendResult as K, type FlareAuthConfig as L, type FlareAuthHydrationInput as M, type FlareAuthHydrationOptions as N, type FlareAuthProviderId as O, type FlareAuthProviderPublicConfig as P, type FlareAuthSession as Q, type FlareAuthUser as R, type FlareRule as S, type FlareStorageAutoConfig as T, type FlareStorageAwsConfig as U, type FlareStorageDeleteInput as V, type FlareStorageDownloadInput as W, type FlareStorageObjectResult as X, type FlareStorageRulesHistoryResult as Y, type FlareStorageRulesPolicy as Z, type FlareStorageServer as _, type AggregateSpec as a, type FlareStorageServerPatchInput as a0, FlareStorageSignedAction as a1, type FlareStorageSignedUrlInput as a2, type FlareStorageSignedUrlResult as a3, type FlareStorageTransferManagerConfig as a4, type FlareStorageUploadInput as a5, type GetObjectInput as a6, type GetObjectResult as a7, type GetObjectUrlInput as a8, type GroupByClause as a9, type RulePermission as aA, type SecurityRuleEntry as aB, type SecurityRulesMap as aC, type SendEmailInput as aD, type SendPushNotificationInput as aE, type SnapshotEvent as aF, type StorageBucket as aG, type StorageBucketInput as aH, type StorageObjectMeta as aI, type StorageProgress as aJ, type StorageSignedUrlInput as aK, type StreamFlushReason as aL, type StructuredJoinClause as aM, type StructuredQuery as aN, type SubscribeOptions as aO, type SubscriptionCallback as aP, type SubscriptionData as aQ, type SubscriptionError as aR, type SubscriptionErrorCallback as aS, type SubscriptionHandle as aT, type VectorFieldConfig as aU, type VectorSearchClause as aV, type VerifyEmailLinkInput as aW, type WhereCondition as aX, flareRulesToSecurityMap as aY, securityMapToFlareRules as aZ, type HavingClause as aa, type HeadObjectInput as ab, type HeadObjectsInput as ac, type JoinClause as ad, type JoinQueryPattern as ae, type ListObjectsInput as af, type ListObjectsResult as ag, type NestedJoinClause as ah, type OfflineOperation as ai, type OrFilter as aj, type OrderByClause as ak, type PresenceCallback as al, type PresenceJoinCallback as am, type PresenceLeaveCallback as an, type PresenceMember as ao, type PushSendResult as ap, type PutObjectInput as aq, type PutObjectResult as ar, type QueryConfig as as, type QueryOperator as at, type QueryPresetMap as au, type QueryPresetParams as av, type QueryPresetRow as aw, type QueryPresetSpec as ax, type QuerySnapshot as ay, type RegisterPushTokenInput as az, type AndFilter as b, type AnyFilter as c, type AuthConfigListener as d, type AuthResult as e, type AuthStateListener as f, type AuthWithPendingVerificationResult as g, type AuthWithTokenResult as h, type BrowserPushTokenOptions as i, type BucketCorsRule as j, type BucketPolicyInput as k, type ChangeOperation as l, type CollectionExternalStore as m, type CollectionStream as n, type CollectionStreamListener as o, type CollectionStreamMeta as p, type CollectionStreamOptions as q, type ConnectionState as r, type CopyObjectInput as s, type CursorValue as t, type DataMapperRegistry as u, type DeleteObjectInput as v, type DeleteObjectsInput as w, type DocAddedCallback as x, type DocChangedCallback as y, type DocDeletedCallback as z };
+export { type FlareStorageObjectResult as $, type AggregateFunction as A, type BrowserPushRegistrationOptions as B, type ChangeEvent as C, type DataMapperFn as D, type DeleteObjectsInput as E, type FlareConfig as F, type DocAddedCallback as G, type DocChangedCallback as H, type DocDeletedCallback as I, type DocUpdatedCallback as J, type DocumentSnapshot as K, type DownloadObjectInput as L, type DownloadObjectResult as M, type EmailLinkVerifyResult as N, type EmailSendResult as O, type FlareAuthConfig as P, type FlareAuthHydrationInput as Q, type FlareAuthHydrationOptions as R, type FlareAuthProviderId as S, type FlareAuthProviderPublicConfig as T, type FlareAuthSession as U, type FlareAuthUser as V, type FlareRule as W, type FlareStorageAutoConfig as X, type FlareStorageAwsConfig as Y, type FlareStorageDeleteInput as Z, type FlareStorageDownloadInput as _, type AggregateSpec as a, type VerifyEmailLinkInput as a$, type FlareStorageRulesHistoryResult as a0, type FlareStorageRulesPolicy as a1, type FlareStorageServer as a2, type FlareStorageServerInput as a3, type FlareStorageServerPatchInput as a4, FlareStorageSignedAction as a5, type FlareStorageSignedUrlInput as a6, type FlareStorageSignedUrlResult as a7, type FlareStorageTransferManagerConfig as a8, type FlareStorageUploadInput as a9, type QueryPresetRow as aA, type QueryPresetSpec as aB, type QuerySnapshot as aC, type RegisterPushTokenInput as aD, type RulePermission as aE, type SecurityRuleEntry as aF, type SecurityRulesMap as aG, type SendEmailInput as aH, type SendPushNotificationInput as aI, type SnapshotEvent as aJ, type StorageBucket as aK, type StorageBucketInput as aL, type StorageObjectMeta as aM, type StorageProgress as aN, type StorageSignedUrlInput as aO, type StreamFlushReason as aP, type StructuredJoinClause as aQ, type StructuredQuery as aR, type SubscribeOptions as aS, type SubscriptionCallback as aT, type SubscriptionData as aU, type SubscriptionError as aV, type SubscriptionErrorCallback as aW, type SubscriptionHandle as aX, type UpdateManyItem as aY, type VectorFieldConfig as aZ, type VectorSearchClause as a_, type GetObjectInput as aa, type GetObjectResult as ab, type GetObjectUrlInput as ac, type GroupByClause as ad, type HavingClause as ae, type HeadObjectInput as af, type HeadObjectsInput as ag, type JoinClause as ah, type JoinQueryPattern as ai, type ListObjectsInput as aj, type ListObjectsResult as ak, type NestedJoinClause as al, type OfflineOperation as am, type OrFilter as an, type OrderByClause as ao, type PresenceCallback as ap, type PresenceJoinCallback as aq, type PresenceLeaveCallback as ar, type PresenceMember as as, type PushSendResult as at, type PutObjectInput as au, type PutObjectResult as av, type QueryConfig as aw, type QueryOperator as ax, type QueryPresetMap as ay, type QueryPresetParams as az, type AndFilter as b, type WhereCondition as b0, flareRulesToSecurityMap as b1, securityMapToFlareRules as b2, type AnyFilter as c, type AuthConfigListener as d, type AuthResult as e, type AuthStateListener as f, type AuthWithPendingVerificationResult as g, type AuthWithTokenResult as h, type BrowserPushTokenOptions as i, type BucketCorsRule as j, type BucketPolicyInput as k, type BulkWriteOperation as l, type BulkWriteOptions as m, type BulkWriteProgress as n, type BulkWriteResult as o, type ChangeOperation as p, type CollectionExternalStore as q, type CollectionStream as r, type CollectionStreamListener as s, type CollectionStreamMeta as t, type CollectionStreamOptions as u, type ConnectionState as v, type CopyObjectInput as w, type CursorValue as x, type DataMapperRegistry as y, type DeleteObjectInput as z };

package/dist/{index-CVwSnXPP.d.cts → index-CRByt4Qw.d.ts}

@@ -1,4 +1,4 @@
-import { aX as WhereCondition, aP as SubscriptionCallback, as as QueryConfig, E as DocUpdatedCallback, z as DocDeletedCallback, y as DocChangedCallback, au as QueryPresetMap, av as QueryPresetParams, aw as QueryPresetRow, a as AggregateSpec, aa as HavingClause, ad as JoinClause, aV as VectorSearchClause, aN as StructuredQuery, aT as SubscriptionHandle, q as CollectionStreamOptions, n as CollectionStream, m as CollectionExternalStore, x as DocAddedCallback, F as FlareConfig, aO as SubscribeOptions, aS as SubscriptionErrorCallback, aR as SubscriptionError, r as ConnectionState, al as PresenceCallback, am as PresenceJoinCallback, an as PresenceLeaveCallback, aU as VectorFieldConfig, ax as QueryPresetSpec, a4 as FlareStorageTransferManagerConfig, aJ as StorageProgress, aH as StorageBucketInput, aG as StorageBucket, k as BucketPolicyInput, Z as FlareStorageRulesPolicy, j as BucketCorsRule, Y as FlareStorageRulesHistoryResult, aq as PutObjectInput, ar as PutObjectResult, a6 as GetObjectInput, a7 as GetObjectResult, a8 as GetObjectUrlInput, H as DownloadObjectInput, I as DownloadObjectResult, ab as HeadObjectInput, aI as StorageObjectMeta, ac as HeadObjectsInput, af as ListObjectsInput, ag as ListObjectsResult, s as CopyObjectInput, v as DeleteObjectInput, w as DeleteObjectsInput, aK as StorageSignedUrlInput, a3 as FlareStorageSignedUrlResult, L as FlareAuthConfig, f as AuthStateListener, d as AuthConfigListener, Q as FlareAuthSession, R as FlareAuthUser, M as FlareAuthHydrationInput, N as FlareAuthHydrationOptions, i as BrowserPushTokenOptions, B as BrowserPushRegistrationOptions, az as RegisterPushTokenInput, aE as SendPushNotificationInput, ap as PushSendResult, e as AuthResult } from './index-Y0Mq_6P9.cjs';
+import { b0 as WhereCondition, aT as SubscriptionCallback, aw as QueryConfig, J as DocUpdatedCallback, I as DocDeletedCallback, H as DocChangedCallback, ay as QueryPresetMap, az as QueryPresetParams, aA as QueryPresetRow, a as AggregateSpec, ae as HavingClause, ah as JoinClause, a_ as VectorSearchClause, aR as StructuredQuery, aX as SubscriptionHandle, u as CollectionStreamOptions, r as CollectionStream, q as CollectionExternalStore, G as DocAddedCallback, m as BulkWriteOptions, o as BulkWriteResult, aY as UpdateManyItem, F as FlareConfig, aS as SubscribeOptions, aW as SubscriptionErrorCallback, aV as SubscriptionError, v as ConnectionState, ap as PresenceCallback, aq as PresenceJoinCallback, ar as PresenceLeaveCallback, aZ as VectorFieldConfig, aB as QueryPresetSpec, a8 as FlareStorageTransferManagerConfig, aN as StorageProgress, aL as StorageBucketInput, aK as StorageBucket, k as BucketPolicyInput, a1 as FlareStorageRulesPolicy, j as BucketCorsRule, a0 as FlareStorageRulesHistoryResult, au as PutObjectInput, av as PutObjectResult, aa as GetObjectInput, ab as GetObjectResult, ac as GetObjectUrlInput, L as DownloadObjectInput, M as DownloadObjectResult, af as HeadObjectInput, aM as StorageObjectMeta, ag as HeadObjectsInput, aj as ListObjectsInput, ak as ListObjectsResult, w as CopyObjectInput, z as DeleteObjectInput, E as DeleteObjectsInput, aO as StorageSignedUrlInput, a7 as FlareStorageSignedUrlResult, P as FlareAuthConfig, f as AuthStateListener, d as AuthConfigListener, U as FlareAuthSession, V as FlareAuthUser, Q as FlareAuthHydrationInput, R as FlareAuthHydrationOptions, i as BrowserPushTokenOptions, B as BrowserPushRegistrationOptions, aD as RegisterPushTokenInput, aI as SendPushNotificationInput, at as PushSendResult, e as AuthResult } from './index-18tMqAtM.js';
 import { AuthToken } from '@zuzjs/auth';
 
 /**
@@ -260,7 +260,26 @@ declare class CollectionReference<T = any, TPresetMap extends QueryPresetMap = {
     onDocUpdated(callback: DocUpdatedCallback<T>): () => void;
     onDocDeleted(callback: DocDeletedCallback<T>): () => void;
     onDocChanged(callback: DocChangedCallback<T>): () => void;
+    private ensureBulkOptions;
+    private toPercent;
+    private emitBulkProgress;
+    private chunkIterable;
+    private assertBulkSignal;
+    private runChunkWorkers;
+    private runBulkWrite;
     add(data: Partial<T>): Promise<DocumentReference<T>>;
+    /**
+     * Create many documents with bounded memory and optional progress reporting.
+     */
+    addMany(items: Iterable<Partial<T>> | AsyncIterable<Partial<T>>, options?: BulkWriteOptions): Promise<BulkWriteResult>;
+    /**
+     * Update many documents by id with bounded memory and optional progress reporting.
+     */
+    updateMany(items: Iterable<UpdateManyItem<T>> | AsyncIterable<UpdateManyItem<T>>, options?: BulkWriteOptions): Promise<BulkWriteResult>;
+    /**
+     * Delete many documents by id with bounded memory and optional progress reporting.
+     */
+    deleteMany(docIds: Iterable<string> | AsyncIterable<string>, options?: BulkWriteOptions): Promise<BulkWriteResult>;
     update(data: Partial<T>): DocumentQueryBuilder<T>;
     delete(): DocumentQueryBuilder<T>;
 }
@@ -470,6 +489,16 @@ declare class FlareBase<TPresetMap extends QueryPresetMap = {}> {
     onConnectionStateChange(listener: ConnectionListener): () => void;
     onError(callback: ErrorListener): () => void;
     collection<T = any>(name: string): CollectionQuery<T, TPresetMap>;
+    /**
+     * Generates a standard 20-character Flare document ID.
+     * UUID v4 without dashes, first 20 chars — matches the Rust server-side format.
+     *
+     * ```ts
+     * const id = db.generateFlareId();
+     * await db.collection('orders').doc(id).set({ total: 99 });
+     * ```
+     */
+    generateFlareId(): string;
     registerQueryPreset<Name extends string, Params extends Record<string, unknown>, Row = any>(name: Name, handler: QueryPresetHandler<Params, Row>): this & FlareBase<TPresetMap & Record<Name, QueryPresetSpec<Params, Row>>>;
     registerQueryPresets<TRegistry extends Record<string, QueryPresetHandler<any, any>>>(presets: TRegistry): this & FlareBase<TPresetMap & {
         [K in keyof TRegistry]: TRegistry[K] extends QueryPresetHandler<infer Params, infer Row> ? QueryPresetSpec<Params, Row> : QueryPresetSpec<Record<string, unknown>, any>;
@@ -477,7 +506,22 @@ declare class FlareBase<TPresetMap extends QueryPresetMap = {}> {
     hasQueryPreset(name: string): boolean;
     applyQueryPreset<Name extends keyof TPresetMap & string>(ref: CollectionReference<any, TPresetMap>, name: Name, params: QueryPresetParams<TPresetMap[Name]>): CollectionQuery<QueryPresetRow<TPresetMap[Name]>, TPresetMap>;
     applyQueryPreset<T = any>(ref: CollectionQuery<T, TPresetMap>, name: string, params?: Record<string, unknown>): CollectionQuery<T, TPresetMap>;
-    doc<T = any>(collection: string): DocumentQueryBuilder<T>;
+    /**
+     * Returns a DocumentReference for the given collection.
+     * When called with no ID, a 20-character Flare ID is auto-generated —
+     * read `.id` from the returned ref before any network call.
+     *
+     * ```ts
+     * const ref = db.doc('orders');          // auto-ID
+     * const id  = ref.id;
+     * await ref.set({ total: 99, id });
+     *
+     * const existing = db.doc('orders', knownId);  // known ID
+     * ```
+     */
+    doc<T = any>(collection: string): DocumentReference<T> & {
+        id: string;
+    };
     doc<T = any>(collection: string, id: string): DocumentReference<T>;
     ping(): Promise<number>;
     call<T = Record<string, unknown>>(topic: string, payload?: Record<string, unknown>): Promise<T>;

package/dist/{index-OUj3iEUt.d.ts → index-DOaU2Hxo.d.cts}

@@ -1,4 +1,4 @@
-import { aX as WhereCondition, aP as SubscriptionCallback, as as QueryConfig, E as DocUpdatedCallback, z as DocDeletedCallback, y as DocChangedCallback, au as QueryPresetMap, av as QueryPresetParams, aw as QueryPresetRow, a as AggregateSpec, aa as HavingClause, ad as JoinClause, aV as VectorSearchClause, aN as StructuredQuery, aT as SubscriptionHandle, q as CollectionStreamOptions, n as CollectionStream, m as CollectionExternalStore, x as DocAddedCallback, F as FlareConfig, aO as SubscribeOptions, aS as SubscriptionErrorCallback, aR as SubscriptionError, r as ConnectionState, al as PresenceCallback, am as PresenceJoinCallback, an as PresenceLeaveCallback, aU as VectorFieldConfig, ax as QueryPresetSpec, a4 as FlareStorageTransferManagerConfig, aJ as StorageProgress, aH as StorageBucketInput, aG as StorageBucket, k as BucketPolicyInput, Z as FlareStorageRulesPolicy, j as BucketCorsRule, Y as FlareStorageRulesHistoryResult, aq as PutObjectInput, ar as PutObjectResult, a6 as GetObjectInput, a7 as GetObjectResult, a8 as GetObjectUrlInput, H as DownloadObjectInput, I as DownloadObjectResult, ab as HeadObjectInput, aI as StorageObjectMeta, ac as HeadObjectsInput, af as ListObjectsInput, ag as ListObjectsResult, s as CopyObjectInput, v as DeleteObjectInput, w as DeleteObjectsInput, aK as StorageSignedUrlInput, a3 as FlareStorageSignedUrlResult, L as FlareAuthConfig, f as AuthStateListener, d as AuthConfigListener, Q as FlareAuthSession, R as FlareAuthUser, M as FlareAuthHydrationInput, N as FlareAuthHydrationOptions, i as BrowserPushTokenOptions, B as BrowserPushRegistrationOptions, az as RegisterPushTokenInput, aE as SendPushNotificationInput, ap as PushSendResult, e as AuthResult } from './index-Y0Mq_6P9.js';
+import { b0 as WhereCondition, aT as SubscriptionCallback, aw as QueryConfig, J as DocUpdatedCallback, I as DocDeletedCallback, H as DocChangedCallback, ay as QueryPresetMap, az as QueryPresetParams, aA as QueryPresetRow, a as AggregateSpec, ae as HavingClause, ah as JoinClause, a_ as VectorSearchClause, aR as StructuredQuery, aX as SubscriptionHandle, u as CollectionStreamOptions, r as CollectionStream, q as CollectionExternalStore, G as DocAddedCallback, m as BulkWriteOptions, o as BulkWriteResult, aY as UpdateManyItem, F as FlareConfig, aS as SubscribeOptions, aW as SubscriptionErrorCallback, aV as SubscriptionError, v as ConnectionState, ap as PresenceCallback, aq as PresenceJoinCallback, ar as PresenceLeaveCallback, aZ as VectorFieldConfig, aB as QueryPresetSpec, a8 as FlareStorageTransferManagerConfig, aN as StorageProgress, aL as StorageBucketInput, aK as StorageBucket, k as BucketPolicyInput, a1 as FlareStorageRulesPolicy, j as BucketCorsRule, a0 as FlareStorageRulesHistoryResult, au as PutObjectInput, av as PutObjectResult, aa as GetObjectInput, ab as GetObjectResult, ac as GetObjectUrlInput, L as DownloadObjectInput, M as DownloadObjectResult, af as HeadObjectInput, aM as StorageObjectMeta, ag as HeadObjectsInput, aj as ListObjectsInput, ak as ListObjectsResult, w as CopyObjectInput, z as DeleteObjectInput, E as DeleteObjectsInput, aO as StorageSignedUrlInput, a7 as FlareStorageSignedUrlResult, P as FlareAuthConfig, f as AuthStateListener, d as AuthConfigListener, U as FlareAuthSession, V as FlareAuthUser, Q as FlareAuthHydrationInput, R as FlareAuthHydrationOptions, i as BrowserPushTokenOptions, B as BrowserPushRegistrationOptions, aD as RegisterPushTokenInput, aI as SendPushNotificationInput, at as PushSendResult, e as AuthResult } from './index-18tMqAtM.cjs';
 import { AuthToken } from '@zuzjs/auth';
 
 /**
@@ -260,7 +260,26 @@ declare class CollectionReference<T = any, TPresetMap extends QueryPresetMap = {
     onDocUpdated(callback: DocUpdatedCallback<T>): () => void;
     onDocDeleted(callback: DocDeletedCallback<T>): () => void;
     onDocChanged(callback: DocChangedCallback<T>): () => void;
+    private ensureBulkOptions;
+    private toPercent;
+    private emitBulkProgress;
+    private chunkIterable;
+    private assertBulkSignal;
+    private runChunkWorkers;
+    private runBulkWrite;
     add(data: Partial<T>): Promise<DocumentReference<T>>;
+    /**
+     * Create many documents with bounded memory and optional progress reporting.
+     */
+    addMany(items: Iterable<Partial<T>> | AsyncIterable<Partial<T>>, options?: BulkWriteOptions): Promise<BulkWriteResult>;
+    /**
+     * Update many documents by id with bounded memory and optional progress reporting.
+     */
+    updateMany(items: Iterable<UpdateManyItem<T>> | AsyncIterable<UpdateManyItem<T>>, options?: BulkWriteOptions): Promise<BulkWriteResult>;
+    /**
+     * Delete many documents by id with bounded memory and optional progress reporting.
+     */
+    deleteMany(docIds: Iterable<string> | AsyncIterable<string>, options?: BulkWriteOptions): Promise<BulkWriteResult>;
     update(data: Partial<T>): DocumentQueryBuilder<T>;
     delete(): DocumentQueryBuilder<T>;
 }
@@ -470,6 +489,16 @@ declare class FlareBase<TPresetMap extends QueryPresetMap = {}> {
     onConnectionStateChange(listener: ConnectionListener): () => void;
     onError(callback: ErrorListener): () => void;
     collection<T = any>(name: string): CollectionQuery<T, TPresetMap>;
+    /**
+     * Generates a standard 20-character Flare document ID.
+     * UUID v4 without dashes, first 20 chars — matches the Rust server-side format.
+     *
+     * ```ts
+     * const id = db.generateFlareId();
+     * await db.collection('orders').doc(id).set({ total: 99 });
+     * ```
+     */
+    generateFlareId(): string;
     registerQueryPreset<Name extends string, Params extends Record<string, unknown>, Row = any>(name: Name, handler: QueryPresetHandler<Params, Row>): this & FlareBase<TPresetMap & Record<Name, QueryPresetSpec<Params, Row>>>;
     registerQueryPresets<TRegistry extends Record<string, QueryPresetHandler<any, any>>>(presets: TRegistry): this & FlareBase<TPresetMap & {
         [K in keyof TRegistry]: TRegistry[K] extends QueryPresetHandler<infer Params, infer Row> ? QueryPresetSpec<Params, Row> : QueryPresetSpec<Record<string, unknown>, any>;
@@ -477,7 +506,22 @@ declare class FlareBase<TPresetMap extends QueryPresetMap = {}> {
     hasQueryPreset(name: string): boolean;
     applyQueryPreset<Name extends keyof TPresetMap & string>(ref: CollectionReference<any, TPresetMap>, name: Name, params: QueryPresetParams<TPresetMap[Name]>): CollectionQuery<QueryPresetRow<TPresetMap[Name]>, TPresetMap>;
     applyQueryPreset<T = any>(ref: CollectionQuery<T, TPresetMap>, name: string, params?: Record<string, unknown>): CollectionQuery<T, TPresetMap>;
-    doc<T = any>(collection: string): DocumentQueryBuilder<T>;
+    /**
+     * Returns a DocumentReference for the given collection.
+     * When called with no ID, a 20-character Flare ID is auto-generated —
+     * read `.id` from the returned ref before any network call.
+     *
+     * ```ts
+     * const ref = db.doc('orders');          // auto-ID
+     * const id  = ref.id;
+     * await ref.set({ total: 99, id });
+     *
+     * const existing = db.doc('orders', knownId);  // known ID
+     * ```
+     */
+    doc<T = any>(collection: string): DocumentReference<T> & {
+        id: string;
+    };
     doc<T = any>(collection: string, id: string): DocumentReference<T>;
     ping(): Promise<number>;
     call<T = Record<string, unknown>>(topic: string, payload?: Record<string, unknown>): Promise<T>;