@ariestools/cli 0.1.9 → 0.1.10

package/dist/node/datalake.d.ts

@@ -3,6 +3,97 @@
 export type AuthTokenSource = string | (() => string | Promise<string>)
 export type PayloadsAuthTokenSource = AuthTokenSource
 
+export type DatalakeRole = 'viewer' | 'runner'
+export type DatalakePrincipal = string
+export type DatalakeTier = 'small' | 'medium' | 'large' | 'archive'
+export type DatalakeRegion = 'us-west-2' | 'us-east-1' | 'eu-west-1'
+export type DatalakeStatus =
+  | 'pending'
+  | 'provisioning'
+  | 'ready'
+  | 'resizing'
+  | 'deprovisioning'
+  | 'deleted'
+  | 'error'
+
+export interface RateLimitOverrides {
+  anonymousPerMinute?: number
+  authenticatedPerMinute?: number
+  burstFactor?: number
+}
+
+export interface DatalakeConfig {
+  allowedSchemas?: string[]
+  disallowedSchemas?: string[]
+  iops?: number
+  rateLimits?: RateLimitOverrides
+  region?: DatalakeRegion
+  retentionDays?: number | null
+  sizeBytes?: number
+  tier: DatalakeTier
+  /** @deprecated No-op; archivist recomputes hashes trustlessly. */
+  verifyHashes?: boolean
+}
+
+export interface AclEntry {
+  grantedAt: string
+  grantedBy?: string
+  principal: DatalakePrincipal
+  role: DatalakeRole
+}
+
+export interface DatalakeUsage {
+  bytesStored: number
+  bytesStoredLimit: number
+  payloadCount: number
+  readsLast24h: number
+  writesLast24h: number
+}
+
+export interface DatalakeDescriptor {
+  acl: AclEntry[]
+  config: DatalakeConfig
+  createdAt: string
+  errorMessage?: string
+  id: string
+  name: string
+  ownerId: string
+  status: DatalakeStatus
+  updatedAt: string
+  url?: string
+  usage?: DatalakeUsage
+}
+
+export interface DatalakeToken {
+  datalakeId: string
+  expiresAt: string
+  role: DatalakeRole
+  token: string
+  url: string
+}
+
+export interface CreateDatalakeRequest {
+  config: DatalakeConfig
+  name: string
+}
+
+export interface GrantRequest {
+  datalakeId: string
+  principal: DatalakePrincipal
+  role: DatalakeRole
+}
+
+export interface RevokeRequest {
+  datalakeId: string
+  principal: DatalakePrincipal
+}
+
+export interface TokenRequest {
+  datalakeId: string
+  role: DatalakeRole
+  ttlSeconds?: number
+}
+
 export interface StoredCredentials {
   authToken: string
   baseUrl: string
@@ -34,10 +125,29 @@ export interface RestPayloadsClientOptions {
   fetchImpl?: typeof fetch
 }
 
+export interface DatalakeInsertSummary {
+  duplicates: number
+  rejected: string[]
+}
+
+/** Result of PayloadsClient.insert — matches RestPayloadsClient runtime. */
 export interface InsertPayloadsResult {
-  duplicates?: number
+  inserted: unknown[]
+  summary: DatalakeInsertSummary
+}
+
+export interface NextPayloadsResult {
+  nextCursor?: string
   payloads: unknown[]
-  rejected?: string[]
+}
+
+export interface DatalakeUsageReport {
+  datalakeId: string
+  payloadCount: number
+  rateLimits?: {
+    anonymous?: { limit: number; remaining: number }
+    authenticated?: { limit: number; remaining: number }
+  }
 }
 
 export interface PayloadsClient {
@@ -46,39 +156,44 @@ export interface PayloadsClient {
   get(hash: string): Promise<unknown>
   getMany(hashes: string[]): Promise<unknown[]>
   insert(payloads: unknown[]): Promise<InsertPayloadsResult>
-  next(options?: { cursor?: string; limit?: number }): Promise<{ nextCursor?: string; payloads: unknown[] }>
-  usage(): Promise<{ datalakeId: string; payloadCount: number }>
+  next(options?: {
+    cursor?: string
+    limit?: number
+    order?: 'asc' | 'desc'
+    schemas?: string[]
+  }): Promise<NextPayloadsResult>
+  usage(): Promise<DatalakeUsageReport>
 }
 
 export interface DatalakeClient {
-  create(body: unknown): Promise<unknown>
-  destroy(id: string): Promise<void>
-  get(id: string): Promise<unknown>
-  grant(id: string, body: unknown): Promise<unknown>
-  list(): Promise<unknown[]>
-  mintToken(id: string, body?: unknown): Promise<unknown>
-  revoke(id: string, body: unknown): Promise<void>
+  create(request: CreateDatalakeRequest): Promise<DatalakeDescriptor>
+  describe(idOrName: string): Promise<DatalakeDescriptor>
+  destroy(idOrName: string): Promise<void>
+  grant(request: GrantRequest): Promise<DatalakeDescriptor>
+  list(): Promise<DatalakeDescriptor[]>
+  mintToken(request: TokenRequest): Promise<DatalakeToken>
+  revoke(request: RevokeRequest): Promise<DatalakeDescriptor>
 }
 
 export declare function createDatalakeClient(options?: CreateDatalakeClientOptions): DatalakeClient
 export declare class LocalDatalakeClient implements DatalakeClient {
-  create(body: unknown): Promise<unknown>
-  destroy(id: string): Promise<void>
-  get(id: string): Promise<unknown>
-  grant(id: string, body: unknown): Promise<unknown>
-  list(): Promise<unknown[]>
-  mintToken(id: string, body?: unknown): Promise<unknown>
-  revoke(id: string, body: unknown): Promise<void>
+  create(request: CreateDatalakeRequest): Promise<DatalakeDescriptor>
+  describe(idOrName: string): Promise<DatalakeDescriptor>
+  destroy(idOrName: string): Promise<void>
+  grant(request: GrantRequest): Promise<DatalakeDescriptor>
+  list(): Promise<DatalakeDescriptor[]>
+  mintToken(request: TokenRequest): Promise<DatalakeToken>
+  revoke(request: RevokeRequest): Promise<DatalakeDescriptor>
 }
 export declare class RestDatalakeClient implements DatalakeClient {
   constructor(options: RestDatalakeClientOptions)
-  create(body: unknown): Promise<unknown>
-  destroy(id: string): Promise<void>
-  get(id: string): Promise<unknown>
-  grant(id: string, body: unknown): Promise<unknown>
-  list(): Promise<unknown[]>
-  mintToken(id: string, body?: unknown): Promise<unknown>
-  revoke(id: string, body: unknown): Promise<void>
+  create(request: CreateDatalakeRequest): Promise<DatalakeDescriptor>
+  describe(idOrName: string): Promise<DatalakeDescriptor>
+  destroy(idOrName: string): Promise<void>
+  grant(request: GrantRequest): Promise<DatalakeDescriptor>
+  list(): Promise<DatalakeDescriptor[]>
+  mintToken(request: TokenRequest): Promise<DatalakeToken>
+  revoke(request: RevokeRequest): Promise<DatalakeDescriptor>
 }
 export declare class RestPayloadsClient implements PayloadsClient {
   constructor(options: RestPayloadsClientOptions)
@@ -87,8 +202,13 @@ export declare class RestPayloadsClient implements PayloadsClient {
   get(hash: string): Promise<unknown>
   getMany(hashes: string[]): Promise<unknown[]>
   insert(payloads: unknown[]): Promise<InsertPayloadsResult>
-  next(options?: { cursor?: string; limit?: number }): Promise<{ nextCursor?: string; payloads: unknown[] }>
-  usage(): Promise<{ datalakeId: string; payloadCount: number }>
+  next(options?: {
+    cursor?: string
+    limit?: number
+    order?: 'asc' | 'desc'
+    schemas?: string[]
+  }): Promise<NextPayloadsResult>
+  usage(): Promise<DatalakeUsageReport>
 }
 
 export declare function loadCredentials(): StoredCredentials | WalletJwtCredentials | undefined

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ariestools/cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Aries Tools CLI - A suite of tools by Arie Trouw",
   "keywords": [
     "ariestools",
@@ -34,23 +34,25 @@
   ],
   "dependencies": {
     "@opentelemetry/api": "~1.9.1",
+    "@xyo-network/archivist-lmdb": "~7.2.1",
     "@xyo-network/sdk-protocol": "~7.2.2",
     "async-mutex": "~0.5.0",
     "ethers": "~6.17.0",
     "imghash": "~1.1.4",
     "lmdb": "~3.5.6",
     "pdq-wasm": "~0.3.9",
+    "s3rver": "~3.7.1",
     "sharp": "~0.35.3",
     "sharp-phash": "~2.2.0",
     "zod": "~4.4.3",
-    "@ariestools/aries-dapp-core": "~0.1.9",
-    "@xyo-network/wallet-xl1-cli": "~0.1.9",
-    "@ariestools/aries-dapp-serve": "~0.1.9"
+    "@ariestools/aries-dapp-core": "~0.1.10",
+    "@xyo-network/wallet-xl1-cli": "~0.1.10",
+    "@ariestools/aries-dapp-serve": "~0.1.10"
   },
   "devDependencies": {
-    "@ariestools/sdk": "~8.1.2",
-    "@ariestools/toolchain": "~8.7.20",
-    "@ariestools/tsconfig": "~8.7.20",
+    "@ariestools/sdk": "~8.1.3",
+    "@ariestools/toolchain": "~8.7.21",
+    "@ariestools/tsconfig": "~8.7.21",
     "@metamask/json-rpc-engine": "~10.5.0",
     "@types/node": "~26.1.1",
     "@xyo-network/sdk": "~7.2.1",
@@ -61,8 +63,8 @@
     "typescript": "~6.0.3",
     "vite": "~8.1.5",
     "vitest": "~4.1.10",
-    "@ariestools/cli-lib": "~0.1.9",
-    "@ariestools/aries-datalake-client": "~0.1.9"
+    "@ariestools/aries-datalake-client": "~0.1.10",
+    "@ariestools/cli-lib": "~0.1.10"
   },
   "engines": {
     "node": ">=18.17.1"