Skip to main content

Document Metadata

Access metadata information for a document.

Definition​

await zkdb
  .db(databaseName: string)
  .collection(collectionName: string)
  .findOne(filter: Record<string, any>)
  .metadata.info(): Promise<TDocumentMetadataResponse>;

Parameters​

  • None

Returns​

  • Promise<TDocumentMetadataResponse>: Returns comprehensive document metadata including creation timestamp, last modification date, owner information, permission settings, and version history. This provides complete administrative and audit information for document lifecycle management.
type TDocumentMetadataResponse = {
  docId: string;
  createdAt: string;
  updatedAt: string;
  owner: string;
  permission: number;
};

Example​

import { ZkDatabase } from 'zkdb';

const zkdb = await ZkDatabase.connect({
  userName: "chiro-user",
  privateKey: "EKFTciRxyxshZjimay9sktsn7v5PvmC5zPq7q4JnitHUytxUVnFP",
  environment: "node",
  // This URL is for test environment
  url: "https://api.zkdatabase.org/graphql",
});

await zkdb.auth.signIn();

const dbTest = zkdb.db('zkdb_test');
const collection = dbTest.collection('Shirt');
const doc = await collection.findOne({ name: 'Shirt 1' });
const metadata = await doc.metadata.info();
console.log('Document metadata:', metadata);

await zkdb.auth.signOut();

Result:​

{
  "docId": "6t7...",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-02T00:00:00.000Z",
  "owner": "chiro-user",
  "permission": 983296
}