@gokiteam/goki-dev-client 0.2.2 → 0.2.3

package/dist/client.d.ts

@@ -178,6 +178,14 @@ export declare class FirestoreClient {
     private client;
     constructor(client: AxiosInstance);
     private call;
+    /**
+     * Converts a plain JS value to a Firestore REST API typed value.
+     */
+    private toFirestoreValue;
+    /**
+     * Converts a plain JS object to Firestore REST API fields format.
+     */
+    private toFirestoreFields;
     /**
      * Parses a Firestore REST API typed value into a plain JS value.
      */
@@ -220,6 +228,30 @@ export declare class FirestoreClient {
     waitForCondition(params: Types.WaitForConditionRequest & {
         type: 'firestore';
     }): Promise<Types.WaitForConditionResponse>;
+    createDocument(params: Types.CreateDocumentRequest): Promise<{
+        document: Types.FirestoreDocument;
+    }>;
+    setDocument(params: Types.SetDocumentRequest): Promise<{
+        document: Types.FirestoreDocument;
+    }>;
+    updateDocument(params: Types.UpdateDocumentRequest): Promise<{
+        document: Types.FirestoreDocument;
+    }>;
+    deleteDocument(params: Types.DeleteDocumentRequest): Promise<void>;
+    clearCollection(params: Types.ClearCollectionRequest): Promise<{
+        deletedCount: number;
+    } & {
+        traceId: string;
+    }>;
+    createBatch(params: Types.CreateBatchRequest): Promise<Types.CreateBatchResponse>;
+    listCollections(params?: {
+        traceId?: string;
+    }): Promise<{
+        collections: string[];
+        total: number;
+    } & {
+        traceId: string;
+    }>;
 }
 export declare class MqttClient {
     private client;

package/dist/client.js

@@ -233,6 +233,41 @@ class FirestoreClient {
         const response = await this.client.post(endpoint, data);
         return response.data;
     }
+    /**
+     * Converts a plain JS value to a Firestore REST API typed value.
+     */
+    toFirestoreValue(value) {
+        if (value === null || value === undefined)
+            return { nullValue: null };
+        if (typeof value === 'string')
+            return { stringValue: value };
+        if (typeof value === 'boolean')
+            return { booleanValue: value };
+        if (typeof value === 'number') {
+            if (Number.isInteger(value))
+                return { integerValue: String(value) };
+            return { doubleValue: value };
+        }
+        if (value instanceof Date)
+            return { timestampValue: value.toISOString() };
+        if (Array.isArray(value)) {
+            return { arrayValue: { values: value.map(v => this.toFirestoreValue(v)) } };
+        }
+        if (typeof value === 'object') {
+            return { mapValue: { fields: this.toFirestoreFields(value) } };
+        }
+        return { stringValue: String(value) };
+    }
+    /**
+     * Converts a plain JS object to Firestore REST API fields format.
+     */
+    toFirestoreFields(data) {
+        const fields = {};
+        for (const [key, value] of Object.entries(data)) {
+            fields[key] = this.toFirestoreValue(value);
+        }
+        return fields;
+    }
     /**
      * Parses a Firestore REST API typed value into a plain JS value.
      */
@@ -343,6 +378,69 @@ class FirestoreClient {
         const result = await this.call('/v1/firestore/documents/wait-for', params);
         return result.data;
     }
+    async createDocument(params) {
+        const result = await this.call('/v1/firestore/documents/create', {
+            collectionPath: params.collection,
+            documentId: params.documentId,
+            fields: this.toFirestoreFields(params.data),
+            traceId: params.traceId
+        });
+        return { document: this.parseRawDocument(result.data.document) };
+    }
+    async setDocument(params) {
+        const result = await this.call('/v1/firestore/documents/set', {
+            collectionPath: params.collection,
+            documentId: params.documentId,
+            fields: this.toFirestoreFields(params.data),
+            traceId: params.traceId
+        });
+        return { document: this.parseRawDocument(result.data.document) };
+    }
+    async updateDocument(params) {
+        const result = await this.call('/v1/firestore/documents/update', {
+            collectionPath: params.collection,
+            documentId: params.documentId,
+            fields: this.toFirestoreFields(params.data),
+            traceId: params.traceId
+        });
+        return { document: this.parseRawDocument(result.data.document) };
+    }
+    async deleteDocument(params) {
+        await this.call('/v1/firestore/documents/delete', {
+            collectionPath: params.collection,
+            documentId: params.documentId,
+            traceId: params.traceId
+        });
+    }
+    async clearCollection(params) {
+        const result = await this.call('/v1/firestore/collection/clear', {
+            collectionPath: params.collection,
+            traceId: params.traceId
+        });
+        return result.data;
+    }
+    async createBatch(params) {
+        const documents = params.documents.map(doc => ({
+            documentId: doc.id,
+            fields: this.toFirestoreFields(doc.data)
+        }));
+        const result = await this.call('/v1/firestore/documents/create-batch', {
+            collectionPath: params.collection,
+            documents,
+            traceId: params.traceId
+        });
+        return {
+            createdCount: result.data.createdCount,
+            failedIds: result.data.failedIds,
+            traceId: result.data.traceId
+        };
+    }
+    async listCollections(params = {}) {
+        const result = await this.call('/v1/firestore/collections/list', {
+            traceId: params.traceId
+        });
+        return result.data;
+    }
 }
 exports.FirestoreClient = FirestoreClient;
 // ============================================================================

package/dist/types.d.ts

@@ -130,6 +130,47 @@ export interface DeleteBatchResponse {
     failedIds: string[];
     traceId: string;
 }
+export interface CreateDocumentRequest {
+    collection: string;
+    documentId?: string;
+    data: Record<string, any>;
+    traceId?: string;
+}
+export interface SetDocumentRequest {
+    collection: string;
+    documentId: string;
+    data: Record<string, any>;
+    traceId?: string;
+}
+export interface UpdateDocumentRequest {
+    collection: string;
+    documentId: string;
+    data: Record<string, any>;
+    traceId?: string;
+}
+export interface DeleteDocumentRequest {
+    collection: string;
+    documentId: string;
+    traceId?: string;
+}
+export interface ClearCollectionRequest {
+    collection: string;
+    traceId?: string;
+}
+export interface CreateBatchDocument {
+    id?: string;
+    data: Record<string, any>;
+}
+export interface CreateBatchRequest {
+    collection: string;
+    documents: CreateBatchDocument[];
+    traceId?: string;
+}
+export interface CreateBatchResponse {
+    createdCount: number;
+    failedIds: string[];
+    traceId: string;
+}
 export interface MqttClientInfo {
     clientId: string;
     connected: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gokiteam/goki-dev-client",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Client SDK for Goki Developer Tools platform",
   "type": "module",
   "main": "./dist/index.js",