@meistrari/vault-sdk 3.1.1 → 3.2.0

package/README.md

@@ -1,11 +1,11 @@
-# @meistrari/vault-sdk-sdk
+# Vault SDK
 
-This is the SDK for Vault V2.
+TypeScript SDK for interacting with the Vault file storage service. Provides file upload, download, streaming, hierarchy management, permalinks, and vault reference utilities.
 
 ## Installation
 
 ```bash
-ni @meistrari/vault-sdk
+bun add @meistrari/vault-sdk
 ```
 
 ## Table of Contents
@@ -17,6 +17,8 @@ ni @meistrari/vault-sdk
   - [VaultFile](#vaultfile)
   - [Vault Client](#vault-client)
   - [Permalinks](#permalinks)
+- [File Hierarchies](#file-hierarchies)
+- [Vault Reference Utilities](#vault-reference-utilities)
 - [Advanced Usage](#advanced-usage)
 
 ## Core Concepts
@@ -332,6 +334,50 @@ Deletes the permalink.
 await permalink.delete()
 ```
 
+## File Hierarchies
+
+Files can be organized into parent-child relationships. See the [File Hierarchy Guide](docs/guides/file-hierarchy.md) for full details, patterns, and best practices.
+
+```ts
+// Create a child file
+const child = await parentFile.createChildFromContent({
+    name: 'page-1.png',
+    content: imageBlob,
+})
+
+// List children
+const children = await parentFile.getChildren()
+
+// Iterate children with auto-pagination
+for await (const child of parentFile.iterateChildren()) {
+    console.log(child.name)
+}
+```
+
+Options for handling edge cases:
+
+- `onMissingParent`: `'error'` (default) or `'create-as-root'`
+- `onParentConflict`: `'error'` (default), `'update-parent-id'`, or `'ignore'`
+
+## Vault Reference Utilities
+
+Utilities for working with `vault://` URIs and S3 presigned URLs.
+
+```ts
+import {
+    isVaultReference,
+    extractVaultReferences,
+    isS3UrlExpired,
+    convertS3UrlToVaultReference,
+    extractVaultFileIdFromS3Url,
+} from '@meistrari/vault-sdk'
+
+isVaultReference('vault://abc-123') // true
+extractVaultReferences('See vault://a and vault://b') // ['vault://a', 'vault://b']
+isS3UrlExpired(presignedUrl) // boolean
+convertS3UrlToVaultReference(s3Url) // 'vault://...'
+```
+
 ## Advanced Usage
 
 ### Complete Workflow Example

package/dist/index.cjs

@@ -237,7 +237,7 @@ function getFileName(content) {
 }
 
 const name = "@meistrari/vault-sdk";
-const version = "3.1.1";
+const version = "3.2.0";
 const license = "UNLICENSED";
 const repository = {
 	type: "git",
@@ -265,10 +265,10 @@ const scripts = {
 };
 const dependencies = {
 	"@meistrari/file-type": "22.0.0",
-	"@meistrari/vault-shared": "0.1.0",
+	"@meistrari/vault-shared": "0.1.1",
 	"mime-types": "3.0.1",
 	ofetch: "1.4.1",
-	zod: "3.23.8"
+	zod: "4.3.6"
 };
 const devDependencies = {
 	"@types/bun": "latest",

package/dist/index.mjs

@@ -231,7 +231,7 @@ function getFileName(content) {
 }
 
 const name = "@meistrari/vault-sdk";
-const version = "3.1.1";
+const version = "3.2.0";
 const license = "UNLICENSED";
 const repository = {
 	type: "git",
@@ -259,10 +259,10 @@ const scripts = {
 };
 const dependencies = {
 	"@meistrari/file-type": "22.0.0",
-	"@meistrari/vault-shared": "0.1.0",
+	"@meistrari/vault-shared": "0.1.1",
 	"mime-types": "3.0.1",
 	ofetch: "1.4.1",
-	zod: "3.23.8"
+	zod: "4.3.6"
 };
 const devDependencies = {
 	"@types/bun": "latest",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/vault-sdk",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -28,10 +28,10 @@
   },
   "dependencies": {
     "@meistrari/file-type": "22.0.0",
-    "@meistrari/vault-shared": "0.1.0",
+    "@meistrari/vault-shared": "0.1.1",
     "mime-types": "3.0.1",
     "ofetch": "1.4.1",
-    "zod": "3.23.8"
+    "zod": "4.3.6"
   },
   "devDependencies": {
     "@types/bun": "latest",