@opendatalabs/vana-sdk 0.1.0-alpha.d7fc764 → 0.1.0-alpha.dba79a3

package/dist/platform/ports/pgp-port.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Port interface for PGP operations
+ *
+ * This interface abstracts away the complexity of the underlying PGP library
+ * and provides a clean, testable API for PGP operations.
+ */
+export interface PgpKeyPairOptions {
+    name?: string;
+    email?: string;
+    passphrase?: string;
+}
+export interface PgpKeyPair {
+    publicKey: string;
+    privateKey: string;
+}
+export interface PgpEncryptInput {
+    text: string;
+    publicKeyArmored: string;
+}
+export interface PgpDecryptInput {
+    messageArmored: string;
+    privateKeyArmored: string;
+    passphrase?: string;
+}
+export interface PgpResult {
+    data: string;
+}
+/**
+ * Clean interface for PGP operations
+ */
+export interface PgpPort {
+    encrypt(input: PgpEncryptInput): Promise<PgpResult>;
+    decrypt(input: PgpDecryptInput): Promise<PgpResult>;
+    generateKeyPair(options?: PgpKeyPairOptions): Promise<PgpKeyPair>;
+}

package/dist/platform/ports/pgp-port.js

@@ -0,0 +1 @@
+//# sourceMappingURL=pgp-port.js.map

package/dist/platform/ports/pgp-port.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/platform/shared/error-utils.d.ts

@@ -12,7 +12,7 @@
  * @param error The original error that occurred
  * @returns Wrapped error with consistent format
  */
-declare function wrapCryptoError(operation: string, error: unknown): Error;
+export declare function wrapCryptoError(operation: string, error: unknown): Error;
 /**
  * Validate encrypted data structure has required fields
  * Ensures encrypted data objects contain the expected properties
@@ -20,6 +20,4 @@ declare function wrapCryptoError(operation: string, error: unknown): Error;
  * @param data The data structure to validate
  * @throws Error if data structure is invalid
  */
-declare function validateEncryptedDataStructure(data: unknown): void;
-
-export { validateEncryptedDataStructure, wrapCryptoError };
+export declare function validateEncryptedDataStructure(data: unknown): void;

package/dist/platform/shared/pgp-utils.cjs

@@ -31,8 +31,8 @@ const STANDARD_PGP_CONFIG = {
 };
 function processPGPKeyOptions(options) {
   return {
-    name: options?.name || "Vana User",
-    email: options?.email || "user@vana.org",
+    name: options?.name ?? "Vana User",
+    email: options?.email ?? "user@vana.org",
     passphrase: options?.passphrase
   };
 }

package/dist/platform/shared/pgp-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/platform/shared/pgp-utils.ts"],"sourcesContent":["/**\n * Shared PGP utilities for platform adapters\n *\n * IMPORTANT: This module contains NO IMPORTS to avoid affecting bundle loading.\n * All functions are pure utilities that can be safely shared across platforms.\n */\n\n/**\n * Standard OpenPGP configuration for consistent behavior across platforms\n * Uses enum values instead of importing openpgp to avoid loading issues\n */\nexport const STANDARD_PGP_CONFIG = {\n  preferredCompressionAlgorithm: 2, // zlib (openpgp.enums.compression.zlib)\n  preferredSymmetricAlgorithm: 7, // aes256 (openpgp.enums.symmetric.aes256)\n} as const;\n\n/**\n * Process PGP key generation options with sensible defaults\n *\n * @param options - Optional key generation parameters\n * @param options.name - The name for the PGP key (defaults to \"Vana User\")\n * @param options.email - The email for the PGP key (defaults to \"user@vana.org\")\n * @param options.passphrase - Optional passphrase to protect the private key\n * @returns Processed options with defaults applied\n */\nexport function processPGPKeyOptions(options?: {\n  name?: string;\n  email?: string;\n  passphrase?: string;\n}) {\n  return {\n    name: options?.name || \"Vana User\",\n    email: options?.email || \"user@vana.org\",\n    passphrase: options?.passphrase,\n  };\n}\n\n/**\n * Get standard PGP key generation parameters\n * Combines default values with standard configuration\n *\n * @param options - Optional key generation parameters\n * @param options.name - The name for the PGP key (defaults to \"Vana User\")\n * @param options.email - The email for the PGP key (defaults to \"user@vana.org\")\n * @param options.passphrase - Optional passphrase to protect the private key\n * @returns Complete key generation parameters object\n */\nexport function getPGPKeyGenParams(options?: {\n  name?: string;\n  email?: string;\n  passphrase?: string;\n}) {\n  const { name, email, passphrase } = processPGPKeyOptions(options);\n\n  return {\n    type: \"rsa\" as const,\n    rsaBits: 2048,\n    userIDs: [{ name, email }],\n    passphrase,\n    config: STANDARD_PGP_CONFIG,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWO,MAAM,sBAAsB;AAAA,EACjC,+BAA+B;AAAA;AAAA,EAC/B,6BAA6B;AAAA;AAC/B;AAWO,SAAS,qBAAqB,SAIlC;AACD,SAAO;AAAA,IACL,MAAM,SAAS,QAAQ;AAAA,IACvB,OAAO,SAAS,SAAS;AAAA,IACzB,YAAY,SAAS;AAAA,EACvB;AACF;AAYO,SAAS,mBAAmB,SAIhC;AACD,QAAM,EAAE,MAAM,OAAO,WAAW,IAAI,qBAAqB,OAAO;AAEhE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;AAAA,IACzB;AAAA,IACA,QAAQ;AAAA,EACV;AACF;","names":[]}
+{"version":3,"sources":["../../../src/platform/shared/pgp-utils.ts"],"sourcesContent":["/**\n * Shared PGP utilities for platform adapters\n *\n * IMPORTANT: This module contains NO IMPORTS to avoid affecting bundle loading.\n * All functions are pure utilities that can be safely shared across platforms.\n */\n\n/**\n * Standard OpenPGP configuration for consistent behavior across platforms\n * Uses enum values instead of importing openpgp to avoid loading issues\n */\nexport const STANDARD_PGP_CONFIG = {\n  preferredCompressionAlgorithm: 2, // zlib (openpgp.enums.compression.zlib)\n  preferredSymmetricAlgorithm: 7, // aes256 (openpgp.enums.symmetric.aes256)\n} as const;\n\n/**\n * Process PGP key generation options with sensible defaults\n *\n * @param options - Optional key generation parameters\n * @param options.name - The name for the PGP key (defaults to \"Vana User\")\n * @param options.email - The email for the PGP key (defaults to \"user@vana.org\")\n * @param options.passphrase - Optional passphrase to protect the private key\n * @returns Processed options with defaults applied\n */\nexport function processPGPKeyOptions(options?: {\n  name?: string;\n  email?: string;\n  passphrase?: string;\n}) {\n  return {\n    name: options?.name ?? \"Vana User\",\n    email: options?.email ?? \"user@vana.org\",\n    passphrase: options?.passphrase,\n  };\n}\n\n/**\n * Get standard PGP key generation parameters\n * Combines default values with standard configuration\n *\n * @param options - Optional key generation parameters\n * @param options.name - The name for the PGP key (defaults to \"Vana User\")\n * @param options.email - The email for the PGP key (defaults to \"user@vana.org\")\n * @param options.passphrase - Optional passphrase to protect the private key\n * @returns Complete key generation parameters object\n */\nexport function getPGPKeyGenParams(options?: {\n  name?: string;\n  email?: string;\n  passphrase?: string;\n}) {\n  const { name, email, passphrase } = processPGPKeyOptions(options);\n\n  return {\n    type: \"rsa\" as const,\n    rsaBits: 2048,\n    userIDs: [{ name, email }],\n    passphrase,\n    config: STANDARD_PGP_CONFIG,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWO,MAAM,sBAAsB;AAAA,EACjC,+BAA+B;AAAA;AAAA,EAC/B,6BAA6B;AAAA;AAC/B;AAWO,SAAS,qBAAqB,SAIlC;AACD,SAAO;AAAA,IACL,MAAM,SAAS,QAAQ;AAAA,IACvB,OAAO,SAAS,SAAS;AAAA,IACzB,YAAY,SAAS;AAAA,EACvB;AACF;AAYO,SAAS,mBAAmB,SAIhC;AACD,QAAM,EAAE,MAAM,OAAO,WAAW,IAAI,qBAAqB,OAAO;AAEhE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;AAAA,IACzB;AAAA,IACA,QAAQ;AAAA,EACV;AACF;","names":[]}

package/dist/platform/shared/pgp-utils.d.ts

@@ -8,7 +8,7 @@
  * Standard OpenPGP configuration for consistent behavior across platforms
  * Uses enum values instead of importing openpgp to avoid loading issues
  */
-declare const STANDARD_PGP_CONFIG: {
+export declare const STANDARD_PGP_CONFIG: {
     readonly preferredCompressionAlgorithm: 2;
     readonly preferredSymmetricAlgorithm: 7;
 };
@@ -21,7 +21,7 @@ declare const STANDARD_PGP_CONFIG: {
  * @param options.passphrase - Optional passphrase to protect the private key
  * @returns Processed options with defaults applied
  */
-declare function processPGPKeyOptions(options?: {
+export declare function processPGPKeyOptions(options?: {
     name?: string;
     email?: string;
     passphrase?: string;
@@ -40,7 +40,7 @@ declare function processPGPKeyOptions(options?: {
  * @param options.passphrase - Optional passphrase to protect the private key
  * @returns Complete key generation parameters object
  */
-declare function getPGPKeyGenParams(options?: {
+export declare function getPGPKeyGenParams(options?: {
     name?: string;
     email?: string;
     passphrase?: string;
@@ -57,5 +57,3 @@ declare function getPGPKeyGenParams(options?: {
         readonly preferredSymmetricAlgorithm: 7;
     };
 };
-
-export { STANDARD_PGP_CONFIG, getPGPKeyGenParams, processPGPKeyOptions };

package/dist/platform/shared/pgp-utils.js

@@ -6,8 +6,8 @@ const STANDARD_PGP_CONFIG = {
 };
 function processPGPKeyOptions(options) {
   return {
-    name: options?.name || "Vana User",
-    email: options?.email || "user@vana.org",
+    name: options?.name ?? "Vana User",
+    email: options?.email ?? "user@vana.org",
     passphrase: options?.passphrase
   };
 }

package/dist/platform/shared/pgp-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/platform/shared/pgp-utils.ts"],"sourcesContent":["/**\n * Shared PGP utilities for platform adapters\n *\n * IMPORTANT: This module contains NO IMPORTS to avoid affecting bundle loading.\n * All functions are pure utilities that can be safely shared across platforms.\n */\n\n/**\n * Standard OpenPGP configuration for consistent behavior across platforms\n * Uses enum values instead of importing openpgp to avoid loading issues\n */\nexport const STANDARD_PGP_CONFIG = {\n  preferredCompressionAlgorithm: 2, // zlib (openpgp.enums.compression.zlib)\n  preferredSymmetricAlgorithm: 7, // aes256 (openpgp.enums.symmetric.aes256)\n} as const;\n\n/**\n * Process PGP key generation options with sensible defaults\n *\n * @param options - Optional key generation parameters\n * @param options.name - The name for the PGP key (defaults to \"Vana User\")\n * @param options.email - The email for the PGP key (defaults to \"user@vana.org\")\n * @param options.passphrase - Optional passphrase to protect the private key\n * @returns Processed options with defaults applied\n */\nexport function processPGPKeyOptions(options?: {\n  name?: string;\n  email?: string;\n  passphrase?: string;\n}) {\n  return {\n    name: options?.name || \"Vana User\",\n    email: options?.email || \"user@vana.org\",\n    passphrase: options?.passphrase,\n  };\n}\n\n/**\n * Get standard PGP key generation parameters\n * Combines default values with standard configuration\n *\n * @param options - Optional key generation parameters\n * @param options.name - The name for the PGP key (defaults to \"Vana User\")\n * @param options.email - The email for the PGP key (defaults to \"user@vana.org\")\n * @param options.passphrase - Optional passphrase to protect the private key\n * @returns Complete key generation parameters object\n */\nexport function getPGPKeyGenParams(options?: {\n  name?: string;\n  email?: string;\n  passphrase?: string;\n}) {\n  const { name, email, passphrase } = processPGPKeyOptions(options);\n\n  return {\n    type: \"rsa\" as const,\n    rsaBits: 2048,\n    userIDs: [{ name, email }],\n    passphrase,\n    config: STANDARD_PGP_CONFIG,\n  };\n}\n"],"mappings":"AAWO,MAAM,sBAAsB;AAAA,EACjC,+BAA+B;AAAA;AAAA,EAC/B,6BAA6B;AAAA;AAC/B;AAWO,SAAS,qBAAqB,SAIlC;AACD,SAAO;AAAA,IACL,MAAM,SAAS,QAAQ;AAAA,IACvB,OAAO,SAAS,SAAS;AAAA,IACzB,YAAY,SAAS;AAAA,EACvB;AACF;AAYO,SAAS,mBAAmB,SAIhC;AACD,QAAM,EAAE,MAAM,OAAO,WAAW,IAAI,qBAAqB,OAAO;AAEhE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;AAAA,IACzB;AAAA,IACA,QAAQ;AAAA,EACV;AACF;","names":[]}
+{"version":3,"sources":["../../../src/platform/shared/pgp-utils.ts"],"sourcesContent":["/**\n * Shared PGP utilities for platform adapters\n *\n * IMPORTANT: This module contains NO IMPORTS to avoid affecting bundle loading.\n * All functions are pure utilities that can be safely shared across platforms.\n */\n\n/**\n * Standard OpenPGP configuration for consistent behavior across platforms\n * Uses enum values instead of importing openpgp to avoid loading issues\n */\nexport const STANDARD_PGP_CONFIG = {\n  preferredCompressionAlgorithm: 2, // zlib (openpgp.enums.compression.zlib)\n  preferredSymmetricAlgorithm: 7, // aes256 (openpgp.enums.symmetric.aes256)\n} as const;\n\n/**\n * Process PGP key generation options with sensible defaults\n *\n * @param options - Optional key generation parameters\n * @param options.name - The name for the PGP key (defaults to \"Vana User\")\n * @param options.email - The email for the PGP key (defaults to \"user@vana.org\")\n * @param options.passphrase - Optional passphrase to protect the private key\n * @returns Processed options with defaults applied\n */\nexport function processPGPKeyOptions(options?: {\n  name?: string;\n  email?: string;\n  passphrase?: string;\n}) {\n  return {\n    name: options?.name ?? \"Vana User\",\n    email: options?.email ?? \"user@vana.org\",\n    passphrase: options?.passphrase,\n  };\n}\n\n/**\n * Get standard PGP key generation parameters\n * Combines default values with standard configuration\n *\n * @param options - Optional key generation parameters\n * @param options.name - The name for the PGP key (defaults to \"Vana User\")\n * @param options.email - The email for the PGP key (defaults to \"user@vana.org\")\n * @param options.passphrase - Optional passphrase to protect the private key\n * @returns Complete key generation parameters object\n */\nexport function getPGPKeyGenParams(options?: {\n  name?: string;\n  email?: string;\n  passphrase?: string;\n}) {\n  const { name, email, passphrase } = processPGPKeyOptions(options);\n\n  return {\n    type: \"rsa\" as const,\n    rsaBits: 2048,\n    userIDs: [{ name, email }],\n    passphrase,\n    config: STANDARD_PGP_CONFIG,\n  };\n}\n"],"mappings":"AAWO,MAAM,sBAAsB;AAAA,EACjC,+BAA+B;AAAA;AAAA,EAC/B,6BAA6B;AAAA;AAC/B;AAWO,SAAS,qBAAqB,SAIlC;AACD,SAAO;AAAA,IACL,MAAM,SAAS,QAAQ;AAAA,IACvB,OAAO,SAAS,SAAS;AAAA,IACzB,YAAY,SAAS;AAAA,EACvB;AACF;AAYO,SAAS,mBAAmB,SAIhC;AACD,QAAM,EAAE,MAAM,OAAO,WAAW,IAAI,qBAAqB,OAAO;AAEhE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;AAAA,IACzB;AAAA,IACA,QAAQ;AAAA,EACV;AACF;","names":[]}

package/dist/platform/shared/stream-utils.d.ts

@@ -11,6 +11,4 @@
  * @param stream The ReadableStream to convert
  * @returns Promise resolving to Uint8Array containing all stream data
  */
-declare function streamToUint8Array(stream: ReadableStream<Uint8Array>): Promise<Uint8Array>;
-
-export { streamToUint8Array };
+export declare function streamToUint8Array(stream: ReadableStream<Uint8Array>): Promise<Uint8Array>;

package/dist/platform/utils.d.ts

@@ -1,25 +1,23 @@
-import { PlatformType, VanaPlatformAdapter } from './interface.js';
-
 /**
  * Platform detection and adapter utilities
  *
  * This module provides utilities for detecting the current runtime environment
  * and creating appropriate platform adapters automatically.
  */
-
+import type { VanaPlatformAdapter, PlatformType } from "./interface";
 /**
  * Detects the current runtime environment
  *
  * @returns The detected platform type
  */
-declare function detectPlatform(): PlatformType;
+export declare function detectPlatform(): PlatformType;
 /**
  * Creates the appropriate platform adapter based on the current environment
  *
  * @returns A platform adapter instance for the current environment
  * @throws {Error} If platform adapters cannot be imported or created
  */
-declare function createPlatformAdapter(): Promise<VanaPlatformAdapter>;
+export declare function createPlatformAdapter(): Promise<VanaPlatformAdapter>;
 /**
  * Creates a platform adapter for a specific platform type
  *
@@ -27,20 +25,20 @@ declare function createPlatformAdapter(): Promise<VanaPlatformAdapter>;
  * @returns A platform adapter instance for the specified platform
  * @throws {Error} If platform adapters cannot be imported or created
  */
-declare function createPlatformAdapterFor(platformType: PlatformType): Promise<VanaPlatformAdapter>;
+export declare function createPlatformAdapterFor(platformType: PlatformType): Promise<VanaPlatformAdapter>;
 /**
  * Checks if the current environment supports the given platform adapter
  *
  * @param platformType - The platform type to check
  * @returns True if the platform is supported, false otherwise
  */
-declare function isPlatformSupported(platformType: PlatformType): boolean;
+export declare function isPlatformSupported(platformType: PlatformType): boolean;
 /**
  * Gets platform-specific capabilities
  *
  * @returns Object describing available platform capabilities
  */
-declare function getPlatformCapabilities(): {
+export declare function getPlatformCapabilities(): {
     platform: PlatformType;
     crypto: {
         webCrypto: false | SubtleCrypto;
@@ -49,5 +47,3 @@ declare function getPlatformCapabilities(): {
     fetch: boolean;
     streams: boolean;
 };
-
-export { createPlatformAdapter, createPlatformAdapterFor, detectPlatform, getPlatformCapabilities, isPlatformSupported };

package/dist/platform/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/platform.browser.d.ts

@@ -1,4 +1,9 @@
-export { BrowserPlatformAdapter } from './platform/browser.js';
-export { VanaPlatformAdapter } from './platform/interface.js';
-export { createBrowserPlatformAdapter, createPlatformAdapterSafe } from './platform/browser-only.js';
-export { detectPlatform, getPlatformCapabilities, isPlatformSupported } from './platform/utils.js';
+/**
+ * Browser-specific platform adapters entry point
+ *
+ * This module provides browser-safe platform utilities without Node.js dependencies.
+ */
+export { BrowserPlatformAdapter } from "./platform/browser";
+export type { VanaPlatformAdapter } from "./platform/interface";
+export { createBrowserPlatformAdapter, createPlatformAdapterSafe, } from "./platform/browser-only";
+export { detectPlatform, isPlatformSupported, getPlatformCapabilities, } from "./platform/utils";

package/dist/platform.d.ts

@@ -1,5 +1,11 @@
-export { BrowserPlatformAdapter } from './platform/browser.js';
-export { NodePlatformAdapter } from './platform/node.js';
-export { VanaPlatformAdapter } from './platform/interface.js';
-export { createPlatformAdapter, createPlatformAdapterFor, detectPlatform, getPlatformCapabilities, isPlatformSupported } from './platform/utils.js';
-export { createBrowserPlatformAdapter, createNodePlatformAdapter, createPlatformAdapterSafe } from './platform/browser-safe.js';
+/**
+ * Platform adapters entry point
+ *
+ * This module provides platform-specific utilities for different environments.
+ * Use this when you need platform detection or adapter creation.
+ */
+export { BrowserPlatformAdapter } from "./platform/browser";
+export { NodePlatformAdapter } from "./platform/node";
+export type { VanaPlatformAdapter } from "./platform/interface";
+export { detectPlatform, createPlatformAdapter, createPlatformAdapterFor, isPlatformSupported, getPlatformCapabilities, } from "./platform/utils";
+export { createNodePlatformAdapter, createBrowserPlatformAdapter, createPlatformAdapterSafe, } from "./platform/browser-safe";

package/dist/platform.node.d.ts

@@ -1,5 +1,10 @@
-export { BrowserPlatformAdapter } from './platform/browser.js';
-export { NodePlatformAdapter } from './platform/node.js';
-export { VanaPlatformAdapter } from './platform/interface.js';
-export { createPlatformAdapter, createPlatformAdapterFor, detectPlatform, getPlatformCapabilities, isPlatformSupported } from './platform/utils.js';
-export { createBrowserPlatformAdapter, createNodePlatformAdapter, createPlatformAdapterSafe } from './platform/browser-safe.js';
+/**
+ * Node.js-specific platform adapters entry point
+ *
+ * This module provides full platform utilities including Node.js support.
+ */
+export { BrowserPlatformAdapter } from "./platform/browser";
+export { NodePlatformAdapter } from "./platform/node";
+export type { VanaPlatformAdapter } from "./platform/interface";
+export { detectPlatform, createPlatformAdapter, createPlatformAdapterFor, isPlatformSupported, getPlatformCapabilities, } from "./platform/utils";
+export { createNodePlatformAdapter, createBrowserPlatformAdapter, createPlatformAdapterSafe, } from "./platform/browser-safe";

package/dist/schemas/dataSchema.schema.json

@@ -0,0 +1,53 @@
+{
+  "$id": "https://vana.org/data-schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Schema",
+  "description": "Meta‑schema that validates a schema object containing a dataset schema and related metadata.",
+  "type": "object",
+  "required": ["name", "version", "dialect", "schema"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Human‑readable name of the contract."
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version of the contract's business logic (e.g. 1.1.0)."
+    },
+    "description": {
+      "type": "string",
+      "description": "Long‑form description of the dataset or API."
+    },
+    "dialect": {
+      "type": "string",
+      "description": "Primary language/format of the data schema.",
+      "enum": ["sqlite", "json"]
+    },
+    "dialectVersion": {
+      "type": "string",
+      "description": "Optional: The version of the dialect's engine or specification the schema targets (e.g., '3' for SQLite v3). Omit for self-describing dialects like json."
+    },
+    "schema": {
+      "description": "The actual schema definition. For 'sqlite', supply a DDL string; for 'json', embed a JSON Schema object."
+    }
+  },
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "properties": { "dialect": { "const": "sqlite" } }
+      },
+      "then": {
+        "properties": { "schema": { "type": "string" } }
+      }
+    },
+    {
+      "if": {
+        "properties": { "dialect": { "const": "json" } }
+      },
+      "then": {
+        "properties": { "schema": { "type": "object" } }
+      }
+    }
+  ]
+}

package/dist/schemas/grantFile.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Vana Data Permission Grant",
+  "description": "User-signed permission that authorizes a specific application to perform operations via a personal server",
+  "type": "object",
+  "required": ["grantee", "operation", "parameters"],
+  "properties": {
+    "grantee": {
+      "type": "string",
+      "pattern": "^0x[0-9a-fA-F]{40}$",
+      "description": "EVM address of the application authorized to use this grant"
+    },
+    "operation": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Operation the grantee is authorized to perform"
+    },
+    "parameters": {
+      "type": "object",
+      "description": "Operation-specific parameters",
+      "additionalProperties": true
+    },
+    "expires": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Optional Unix timestamp when grant expires (seconds since epoch per POSIX.1-2008)"
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "grantee": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
+      "operation": "llm_inference",
+      "parameters": {
+        "prompt": "Analyze this data: {{data}}",
+        "model": "gpt-4",
+        "maxTokens": 2000,
+        "temperature": 0.7
+      },
+      "expires": 1736467579
+    }
+  ]
+}