@autonomys/auto-drive 0.6.2 → 0.6.3

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2024 Autonomys Network (autonomys.xyz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+1. **Attribution**: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+2. **No Warranty**: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+3. **Limitation of Liability**: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---

package/README.md

@@ -1 +1,146 @@
-# auto-drive
+# Auto-Drive
+
+![Autonomys Banner](https://github.com/autonomys/auto-sdk/blob/main/.github/images/autonomys-banner.webp)
+
+[![Latest Github release](https://img.shields.io/github/v/tag/autonomys/auto-sdk.svg)](https://github.com/autonomys/auto-sdk/tags)
+[![Build status of the main branch on Linux/OSX](https://img.shields.io/github/actions/workflow/status/autonomys/auto-sdk/build.yaml?branch=main&label=Linux%2FOSX%20build)](https://github.com/autonomys/auto-sdk/actions/workflows/build.yaml)
+[![npm version](https://badge.fury.io/js/@autonomys%2Fauto-drive.svg)](https://badge.fury.io/js/@autonomys/auto-drive)
+
+## Overview
+
+The **Autonomys Auto Drive SDK** (`@autonomys/auto-drive`) provides utilities for creating and managing IPLD DAGs (InterPlanetary Linked Data Directed Acyclic Graphs) for files and folders. It facilitates chunking large files, handling metadata, and creating folder structures suitable for distributed storage systems like IPFS.
+
+## Features
+
+- **File Chunking and DAG Creation**: Efficiently split large files into smaller chunks and create IPLD DAGs.
+- **Folder Structure Creation**: Generate IPLD DAGs for directory structures.
+- **Metadata Handling**: Add and manage metadata for files and folders.
+- **CID Management**: Utilities for working with Content Identifiers (CIDs).
+- **TypeScript Support**: Fully typed for enhanced developer experience.
+
+## Installation
+
+You can install Auto-Drive using npm or yarn:
+
+```bash
+npm install @autonomys/auto-drive
+```
+
+or
+
+```bash
+yarn add @autonomys/auto-drive
+```
+
+## Usage
+
+### Creating an IPLD DAG from a File
+
+To create an IPLD DAG from a file, you can use the `createFileIPLDDag` function:
+
+```typescript
+import { createFileIPLDDag } from '@autonomys/auto-drive'
+import fs from 'fs'
+
+const fileBuffer = fs.readFileSync('path/to/your/file.txt')
+
+const dag = createFileIPLDDag(fileBuffer, 'file.txt')
+```
+
+### Creating an IPLD DAG from a Folder
+
+To create an IPLD DAG from a folder, you can use the `createFolderIPLDDag` function:
+
+```typescript
+import { createFolderIPLDDag } from '@autonomys/auto-drive'
+import { CID } from 'multiformats'
+
+// Example child CIDs and folder information
+const childCIDs: CID[] = [
+  /* array of CIDs */
+]
+const folderName = 'my-folder'
+const folderSize = 1024 // size in bytes
+
+const folderDag = createFolderIPLDDag(childCIDs, folderName, folderSize)
+```
+
+### Working with CIDs
+
+You can use functions from the `cid` module to work with CIDs:
+
+```typescript
+import { cidOfNode, cidToString, stringToCid } from '@autonomys/auto-drive'
+
+// Create a CID from a node
+const cid = cidOfNode(dag.head)
+
+// Convert the CID to a string
+const cidString = cidToString(cid)
+
+// Parse a string back into a CID
+const parsedCID = stringToCid(cidString)
+```
+
+### Encoding and Decoding Nodes
+
+You can encode and decode IPLD nodes:
+
+```typescript
+import { encodeNode, decodeNode } from '@autonomys/auto-drive'
+
+// Encode a node
+const encodedNode = encodeNode(dag.head)
+
+// Decode a node
+const decodedNode = decodeNode(encodedNode)
+```
+
+### Handling Metadata
+
+To add metadata to a node, you can create a metadata node:
+
+```typescript
+import { createMetadataNode } from '@autonomys/auto-drive'
+
+const metadata = {
+  name: 'My File',
+  description: 'This is a sample file',
+  // ... other metadata fields
+}
+
+const metadataNode = createMetadataNode(metadata)
+```
+
+### Example: Creating a File DAG and Converting to CID
+
+```typescript
+import { createFileIPLDDag, cidOfNode, cidToString } from '@autonomys/auto-drive'
+import fs from 'fs'
+
+const fileBuffer = fs.readFileSync('path/to/your/file.txt')
+
+const dag = createFileIPLDDag(fileBuffer, 'file.txt')
+
+const cid = cidOfNode(dag.headCID)
+const cidString = cidToString(cid)
+
+console.log(`CID of the file DAG: ${cidString}`)
+```
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## Additional Resources
+
+- **Autonomys Academy**: Learn more at [Autonomys Academy](https://academy.autonomys.xyz).
+- **Auto-Utils Package**: Utility functions used alongside `auto-drive` can be found in [`@autonomys/auto-utils`](../Auto-Utils/README.md).
+
+## Contact
+
+If you have any questions or need support, feel free to reach out:
+
+- **GitHub Issues**: [GitHub Issues Page](https://github.com/autonomys/auto-sdk/issues)
+
+We appreciate your feedback and contributions!

package/dist/metadata/offchain/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/metadata/offchain/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,OAAO,EAA8B,MAAM,gBAAgB,CAAA;AAE5F,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,eAAO,MAAM,YAAY,QAClB,OAAO,aACD,MAAM,SACV,MAAM,aACF,MAAM,KAChB,oBAiBF,CAAA"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/metadata/offchain/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAEhE,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,eAAO,MAAM,YAAY,QAClB,OAAO,aACD,MAAM,SACV,MAAM,aACF,MAAM,KAChB,oBAaF,CAAA"}

package/dist/metadata/offchain/file.js

@@ -1,14 +1,13 @@
-import { cidOfNode, cidToString, IPLDNodeData } from '../../index.js';
+import { cidOfNode, cidToString } from '../../index.js';
 export const fileMetadata = (dag, totalSize, name, mimeType) => {
-    const chunks = Array.from(dag.nodes.values()).filter((n) => n.Data && IPLDNodeData.decode(n.Data).data);
     return {
         type: 'file',
         dataCid: cidToString(dag.headCID),
         name,
         mimeType,
         totalSize,
-        totalChunks: chunks.length,
-        chunks: chunks.map((chunk) => {
+        totalChunks: dag.nodes.size,
+        chunks: Array.from(dag.nodes.values()).map((chunk) => {
             var _a, _b;
             return ({
                 cid: cidToString(cidOfNode(chunk)),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@autonomys/auto-drive",
   "packageManager": "yarn@4.1.1",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "license": "MIT",
   "main": "dist/index.js",
   "repository": {
@@ -39,5 +39,5 @@
     "protons": "^7.6.0",
     "protons-runtime": "^5.5.0"
   },
-  "gitHead": "c49eb0479d010f277abe0fde54665a7a06dd00b8"
+  "gitHead": "68a54c6f18e51cb1f32a5997c04230a6107ab631"
 }