@xylabs/aries 0.1.1

package/dist/commands/datalakeFetchCommand.mjs

@@ -0,0 +1,106 @@
+// src/actions/datalake/payloads/fetchPayload.ts
+import { DatalakeApiError } from "@xylabs/aries-datalake-core";
+import chalk from "chalk";
+
+// src/actions/datalake/payloads/mintAndConnect.ts
+import { createDatalakeClient, RestPayloadsClient } from "@xylabs/aries-datalake-client";
+import { XyoPayloadsClient } from "@xylabs/aries-datalake-xl1-adapter";
+
+// src/actions/datalake/resolveTarget.ts
+import { getDefaultDatalake } from "@xylabs/aries-datalake-client";
+function resolveTarget(argValue) {
+  const target = argValue ?? getDefaultDatalake();
+  if (!target) {
+    throw new Error(
+      "No datalake specified and no default set. Pass <name> or run `aries datalake use <name>`."
+    );
+  }
+  return target;
+}
+
+// src/actions/datalake/payloads/mintAndConnect.ts
+async function mintAndConnect(options) {
+  const controlClient = createDatalakeClient();
+  const target = resolveTarget(options.idOrName);
+  const descriptor = await controlClient.describe(target);
+  if (!descriptor.url) {
+    throw new Error(`Datalake ${descriptor.name} has no URL yet (status=${descriptor.status})`);
+  }
+  const token = await controlClient.mintToken({
+    datalakeId: descriptor.id,
+    role: options.role,
+    ttlSeconds: options.ttlSeconds ?? 3600
+  });
+  const clientOptions = {
+    baseUrl: token.url,
+    datalakeId: descriptor.id,
+    authToken: token.token
+  };
+  return {
+    client: options.useXl1Sdk ? new XyoPayloadsClient(clientOptions) : new RestPayloadsClient(clientOptions),
+    datalakeName: descriptor.name,
+    datalakeId: descriptor.id,
+    url: token.url,
+    transport: options.useXl1Sdk ? "xl1-sdk" : "native"
+  };
+}
+
+// src/actions/datalake/payloads/fetchPayload.ts
+async function fetchPayload(options) {
+  const connection = await mintAndConnect({
+    idOrName: options.idOrName,
+    role: "viewer",
+    useXl1Sdk: options.xl1Sdk
+  });
+  try {
+    const payload = await connection.client.get(options.hash);
+    if (options.raw) {
+      process.stdout.write(`${JSON.stringify(payload)}
+`);
+      return;
+    }
+    console.log(chalk.cyan(`${connection.datalakeName} / ${options.hash}`));
+    console.log(JSON.stringify(payload, void 0, 2));
+  } catch (error) {
+    if (error instanceof DatalakeApiError && error.code === "not_found") {
+      console.log(chalk.yellow(`payload not found: ${options.hash}`));
+      process.exitCode = 3;
+      return;
+    }
+    throw error;
+  }
+}
+
+// src/commands/datalakeFetchCommand.ts
+var datalakeFetchCommand = {
+  command: "fetch <hash> [name]",
+  describe: "Fetch a single payload by content hash",
+  builder: (yargs) => yargs.positional("hash", {
+    type: "string",
+    describe: "Content hash of the payload to fetch",
+    demandOption: true
+  }).positional("name", {
+    type: "string",
+    describe: "Datalake name or id (defaults to current)"
+  }).option("raw", {
+    type: "boolean",
+    default: false,
+    describe: "Print only the raw JSON payload (no header)"
+  }).option("xl1-sdk", {
+    type: "boolean",
+    default: false,
+    describe: "Use the real @xyo-network/xl1-protocol-sdk RestDataLakeViewer"
+  }),
+  handler: async (argv) => {
+    await fetchPayload({
+      hash: argv.hash,
+      idOrName: argv.name,
+      raw: argv.raw,
+      xl1Sdk: argv["xl1-sdk"]
+    });
+  }
+};
+export {
+  datalakeFetchCommand
+};
+//# sourceMappingURL=datalakeFetchCommand.mjs.map

package/dist/commands/datalakeFetchCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/datalake/payloads/fetchPayload.ts","../../src/actions/datalake/payloads/mintAndConnect.ts","../../src/actions/datalake/resolveTarget.ts","../../src/commands/datalakeFetchCommand.ts"],"sourcesContent":["import { DatalakeApiError } from '@xylabs/aries-datalake-core'\nimport chalk from 'chalk'\n\nimport { mintAndConnect } from './mintAndConnect.ts'\n\nexport interface FetchPayloadOptions {\n  idOrName?: string\n  hash: string\n  /** If true, print raw JSON without chalk-formatted header. */\n  raw?: boolean\n  /** If true, fetch via the real XL1 SDK's `RestDataLakeViewer`. */\n  xl1Sdk?: boolean\n}\n\nexport async function fetchPayload(options: FetchPayloadOptions): Promise<void> {\n  const connection = await mintAndConnect({\n    idOrName: options.idOrName, role: 'viewer', useXl1Sdk: options.xl1Sdk,\n  })\n  try {\n    const payload = await connection.client.get(options.hash)\n    if (options.raw) {\n      process.stdout.write(`${JSON.stringify(payload)}\\n`)\n      return\n    }\n    console.log(chalk.cyan(`${connection.datalakeName} / ${options.hash}`))\n    console.log(JSON.stringify(payload, undefined, 2))\n  } catch (error) {\n    if (error instanceof DatalakeApiError && error.code === 'not_found') {\n      console.log(chalk.yellow(`payload not found: ${options.hash}`))\n      process.exitCode = 3\n      return\n    }\n    throw error\n  }\n}\n","import type { PayloadsClient } from '@xylabs/aries-datalake-client'\nimport { createDatalakeClient, RestPayloadsClient } from '@xylabs/aries-datalake-client'\nimport type { DatalakeRole } from '@xylabs/aries-datalake-core'\nimport { XyoPayloadsClient } from '@xylabs/aries-datalake-xl1-adapter'\n\nimport { resolveTarget } from '../resolveTarget.ts'\n\nexport interface Connection {\n  client: PayloadsClient\n  datalakeName: string\n  datalakeId: string\n  url: string\n  transport: 'native' | 'xl1-sdk'\n}\n\nexport interface MintAndConnectOptions {\n  idOrName?: string\n  role: DatalakeRole\n  ttlSeconds?: number\n  /**\n   * When `true`, use the real `@xyo-network/xl1-protocol-sdk`\n   * `RestDataLakeRunner` / `RestDataLakeViewer` for insert and get,\n   * proving byte-level wire compatibility. Other methods fall back to the\n   * native `RestPayloadsClient` since the XL1 SDK doesn't implement them.\n   */\n  useXl1Sdk?: boolean\n}\n\n/**\n * Resolves the target datalake, mints a scoped token via the control plane,\n * and returns a data-plane client wired with that token. Centralizes what\n * every payload command has to do before it can talk to the data plane.\n */\nexport async function mintAndConnect(options: MintAndConnectOptions): Promise<Connection> {\n  const controlClient = createDatalakeClient()\n  const target = resolveTarget(options.idOrName)\n  const descriptor = await controlClient.describe(target)\n  if (!descriptor.url) {\n    throw new Error(`Datalake ${descriptor.name} has no URL yet (status=${descriptor.status})`)\n  }\n  const token = await controlClient.mintToken({\n    datalakeId: descriptor.id,\n    role: options.role,\n    ttlSeconds: options.ttlSeconds ?? 3600,\n  })\n  const clientOptions = {\n    baseUrl: token.url,\n    datalakeId: descriptor.id,\n    authToken: token.token,\n  }\n  return {\n    client: options.useXl1Sdk\n      ? new XyoPayloadsClient(clientOptions)\n      : new RestPayloadsClient(clientOptions),\n    datalakeName: descriptor.name,\n    datalakeId: descriptor.id,\n    url: token.url,\n    transport: options.useXl1Sdk ? 'xl1-sdk' : 'native',\n  }\n}\n","import { getDefaultDatalake } from '@xylabs/aries-datalake-client'\n\n/**\n * Resolves the target datalake name/id for commands that take an optional\n * argument. Falls back to the one set via `aries datalake use`.\n */\nexport function resolveTarget(argValue: string | undefined): string {\n  const target = argValue ?? getDefaultDatalake()\n  if (!target) {\n    throw new Error(\n      'No datalake specified and no default set. '\n      + 'Pass <name> or run `aries datalake use <name>`.',\n    )\n  }\n  return target\n}\n","import type { CommandModule } from 'yargs'\n\nimport { fetchPayload } from '../actions/datalake/payloads/index.ts'\n\nexport const datalakeFetchCommand: CommandModule = {\n  command: 'fetch <hash> [name]',\n  describe: 'Fetch a single payload by content hash',\n  builder: yargs =>\n    yargs\n      .positional('hash', {\n        type: 'string',\n        describe: 'Content hash of the payload to fetch',\n        demandOption: true,\n      })\n      .positional('name', {\n        type: 'string',\n        describe: 'Datalake name or id (defaults to current)',\n      })\n      .option('raw', {\n        type: 'boolean',\n        default: false,\n        describe: 'Print only the raw JSON payload (no header)',\n      })\n      .option('xl1-sdk', {\n        type: 'boolean',\n        default: false,\n        describe: 'Use the real @xyo-network/xl1-protocol-sdk RestDataLakeViewer',\n      }),\n  handler: async (argv) => {\n    await fetchPayload({\n      hash: argv.hash as string,\n      idOrName: argv.name as string | undefined,\n      raw: argv.raw as boolean,\n      xl1Sdk: argv['xl1-sdk'] as boolean,\n    })\n  },\n}\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,OAAO,WAAW;;;ACAlB,SAAS,sBAAsB,0BAA0B;AAEzD,SAAS,yBAAyB;;;ACHlC,SAAS,0BAA0B;AAM5B,SAAS,cAAc,UAAsC;AAClE,QAAM,SAAS,YAAY,mBAAmB;AAC9C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;;;ADkBA,eAAsB,eAAe,SAAqD;AACxF,QAAM,gBAAgB,qBAAqB;AAC3C,QAAM,SAAS,cAAc,QAAQ,QAAQ;AAC7C,QAAM,aAAa,MAAM,cAAc,SAAS,MAAM;AACtD,MAAI,CAAC,WAAW,KAAK;AACnB,UAAM,IAAI,MAAM,YAAY,WAAW,IAAI,2BAA2B,WAAW,MAAM,GAAG;AAAA,EAC5F;AACA,QAAM,QAAQ,MAAM,cAAc,UAAU;AAAA,IAC1C,YAAY,WAAW;AAAA,IACvB,MAAM,QAAQ;AAAA,IACd,YAAY,QAAQ,cAAc;AAAA,EACpC,CAAC;AACD,QAAM,gBAAgB;AAAA,IACpB,SAAS,MAAM;AAAA,IACf,YAAY,WAAW;AAAA,IACvB,WAAW,MAAM;AAAA,EACnB;AACA,SAAO;AAAA,IACL,QAAQ,QAAQ,YACZ,IAAI,kBAAkB,aAAa,IACnC,IAAI,mBAAmB,aAAa;AAAA,IACxC,cAAc,WAAW;AAAA,IACzB,YAAY,WAAW;AAAA,IACvB,KAAK,MAAM;AAAA,IACX,WAAW,QAAQ,YAAY,YAAY;AAAA,EAC7C;AACF;;;AD7CA,eAAsB,aAAa,SAA6C;AAC9E,QAAM,aAAa,MAAM,eAAe;AAAA,IACtC,UAAU,QAAQ;AAAA,IAAU,MAAM;AAAA,IAAU,WAAW,QAAQ;AAAA,EACjE,CAAC;AACD,MAAI;AACF,UAAM,UAAU,MAAM,WAAW,OAAO,IAAI,QAAQ,IAAI;AACxD,QAAI,QAAQ,KAAK;AACf,cAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,OAAO,CAAC;AAAA,CAAI;AACnD;AAAA,IACF;AACA,YAAQ,IAAI,MAAM,KAAK,GAAG,WAAW,YAAY,MAAM,QAAQ,IAAI,EAAE,CAAC;AACtE,YAAQ,IAAI,KAAK,UAAU,SAAS,QAAW,CAAC,CAAC;AAAA,EACnD,SAAS,OAAO;AACd,QAAI,iBAAiB,oBAAoB,MAAM,SAAS,aAAa;AACnE,cAAQ,IAAI,MAAM,OAAO,sBAAsB,QAAQ,IAAI,EAAE,CAAC;AAC9D,cAAQ,WAAW;AACnB;AAAA,IACF;AACA,UAAM;AAAA,EACR;AACF;;;AG9BO,IAAM,uBAAsC;AAAA,EACjD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS,WACP,MACG,WAAW,QAAQ;AAAA,IAClB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,cAAc;AAAA,EAChB,CAAC,EACA,WAAW,QAAQ;AAAA,IAClB,MAAM;AAAA,IACN,UAAU;AAAA,EACZ,CAAC,EACA,OAAO,OAAO;AAAA,IACb,MAAM;AAAA,IACN,SAAS;AAAA,IACT,UAAU;AAAA,EACZ,CAAC,EACA,OAAO,WAAW;AAAA,IACjB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,UAAU;AAAA,EACZ,CAAC;AAAA,EACL,SAAS,OAAO,SAAS;AACvB,UAAM,aAAa;AAAA,MACjB,MAAM,KAAK;AAAA,MACX,UAAU,KAAK;AAAA,MACf,KAAK,KAAK;AAAA,MACV,QAAQ,KAAK,SAAS;AAAA,IACxB,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/commands/datalakeGrantCommand.mjs

@@ -0,0 +1,147 @@
+// src/actions/datalake/formatters.ts
+import chalk from "chalk";
+var STATUS_COLORS = {
+  pending: chalk.gray,
+  provisioning: chalk.yellow,
+  ready: chalk.green,
+  resizing: chalk.yellow,
+  deprovisioning: chalk.yellow,
+  deleted: chalk.gray,
+  error: chalk.red
+};
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 ** 2) return `${(bytes / 1024).toFixed(1)} KB`;
+  if (bytes < 1024 ** 3) return `${(bytes / 1024 ** 2).toFixed(1)} MB`;
+  if (bytes < 1024 ** 4) return `${(bytes / 1024 ** 3).toFixed(1)} GB`;
+  return `${(bytes / 1024 ** 4).toFixed(1)} TB`;
+}
+function formatStatus(status) {
+  const colorize = STATUS_COLORS[status] ?? chalk.white;
+  return colorize(status);
+}
+function printRateLimits(limits) {
+  const parts = [];
+  if (limits.authenticatedPerMinute !== void 0) parts.push(`auth=${limits.authenticatedPerMinute}/min`);
+  if (limits.anonymousPerMinute !== void 0) parts.push(`anon=${limits.anonymousPerMinute}/min`);
+  if (limits.burstFactor !== void 0) parts.push(`burst=${limits.burstFactor}x`);
+  if (parts.length > 0) {
+    console.log(`  ${chalk.gray("limits:")}     ${parts.join(" ")}`);
+  }
+}
+function printUsage(usage) {
+  console.log();
+  console.log(chalk.cyan("  usage"));
+  console.log(`    ${chalk.gray("payloads:")}   ${usage.payloadCount}`);
+  console.log(`    ${chalk.gray("stored:")}     ${formatBytes(usage.bytesStored)} / ${formatBytes(usage.bytesStoredLimit)}`);
+  console.log(`    ${chalk.gray("reads 24h:")}  ${usage.readsLast24h}`);
+  console.log(`    ${chalk.gray("writes 24h:")} ${usage.writesLast24h}`);
+}
+function printAcl(acl) {
+  if (acl.length === 0) return;
+  console.log();
+  console.log(chalk.cyan("  access"));
+  for (const entry of acl) {
+    const principal = entry.principal === "public" ? chalk.yellow("public") : entry.principal;
+    console.log(`    ${principal.padEnd(24)} ${chalk.magenta(entry.role)}  ${chalk.gray(entry.grantedAt)}`);
+  }
+}
+function printDatalakeDetail(datalake) {
+  console.log(chalk.cyan(`
+${datalake.name}`));
+  console.log(`  ${chalk.gray("id:")}         ${datalake.id}`);
+  console.log(`  ${chalk.gray("status:")}     ${formatStatus(datalake.status)}`);
+  if (datalake.url) {
+    console.log(`  ${chalk.gray("url:")}        ${datalake.url}`);
+  }
+  console.log(`  ${chalk.gray("owner:")}      ${datalake.ownerId}`);
+  console.log(`  ${chalk.gray("tier:")}       ${datalake.config.tier}`);
+  console.log(`  ${chalk.gray("region:")}     ${datalake.config.region ?? "\u2014"}`);
+  console.log(`  ${chalk.gray("size:")}       ${datalake.config.sizeBytes ? formatBytes(datalake.config.sizeBytes) : "\u2014"}`);
+  console.log(`  ${chalk.gray("iops:")}       ${datalake.config.iops ?? "\u2014"}`);
+  console.log(`  ${chalk.gray("retention:")}  ${datalake.config.retentionDays ?? "forever"}`);
+  if (datalake.config.verifyHashes) {
+    console.log(`  ${chalk.gray("verify:")}     ${chalk.green("hashes enforced")}`);
+  }
+  if (datalake.config.rateLimits) printRateLimits(datalake.config.rateLimits);
+  console.log(`  ${chalk.gray("created:")}    ${datalake.createdAt}`);
+  console.log(`  ${chalk.gray("updated:")}    ${datalake.updatedAt}`);
+  if (datalake.usage) printUsage(datalake.usage);
+  printAcl(datalake.acl);
+  if (datalake.errorMessage) {
+    console.log();
+    console.log(`  ${chalk.red("error:")} ${datalake.errorMessage}`);
+  }
+}
+
+// src/actions/datalake/resolveTarget.ts
+import { getDefaultDatalake } from "@xylabs/aries-datalake-client";
+function resolveTarget(argValue) {
+  const target = argValue ?? getDefaultDatalake();
+  if (!target) {
+    throw new Error(
+      "No datalake specified and no default set. Pass <name> or run `aries datalake use <name>`."
+    );
+  }
+  return target;
+}
+
+// src/actions/datalake/grantAccess.ts
+import { createDatalakeClient } from "@xylabs/aries-datalake-client";
+import chalk2 from "chalk";
+async function grantAccess(options) {
+  const client = createDatalakeClient();
+  const target = resolveTarget(options.idOrName);
+  if (options.principal === "public" && options.role === "runner" && !options.confirmPublic) {
+    console.log(chalk2.yellow(
+      "Granting `public runner` makes anonymous writes possible. Re-run with --confirm-public to proceed."
+    ));
+    process.exitCode = 1;
+    return;
+  }
+  const descriptor = await client.describe(target);
+  const updated = await client.grant({
+    datalakeId: descriptor.id,
+    principal: options.principal,
+    role: options.role
+  });
+  console.log(chalk2.green(`granted ${options.role} to ${options.principal} on ${updated.name}`));
+  printDatalakeDetail(updated);
+}
+
+// src/commands/datalakeGrantCommand.ts
+var datalakeGrantCommand = {
+  command: "grant <name> <principal>",
+  describe: 'Grant a role on a datalake (principal=user-id or "public")',
+  builder: (yargs) => yargs.positional("name", {
+    type: "string",
+    describe: "Datalake name or id",
+    demandOption: true
+  }).positional("principal", {
+    type: "string",
+    describe: 'User id, or the literal "public"',
+    demandOption: true
+  }).option("role", {
+    alias: "r",
+    type: "string",
+    choices: ["viewer", "runner"],
+    default: "viewer",
+    describe: "Role to grant"
+  }).option("confirm-public", {
+    type: "boolean",
+    default: false,
+    describe: "Required to grant `public runner` (anonymous writes)"
+  }),
+  handler: async (argv) => {
+    await grantAccess({
+      idOrName: argv.name,
+      principal: argv.principal,
+      role: argv.role,
+      confirmPublic: argv["confirm-public"]
+    });
+  }
+};
+export {
+  datalakeGrantCommand
+};
+//# sourceMappingURL=datalakeGrantCommand.mjs.map

package/dist/commands/datalakeGrantCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/datalake/formatters.ts","../../src/actions/datalake/resolveTarget.ts","../../src/actions/datalake/grantAccess.ts","../../src/commands/datalakeGrantCommand.ts"],"sourcesContent":["import type {\n  DatalakeDescriptor, DatalakeStatus, DatalakeUsage, RateLimitOverrides,\n} from '@xylabs/aries-datalake-core'\nimport chalk from 'chalk'\n\nconst STATUS_COLORS: Record<DatalakeStatus, (s: string) => string> = {\n  pending: chalk.gray,\n  provisioning: chalk.yellow,\n  ready: chalk.green,\n  resizing: chalk.yellow,\n  deprovisioning: chalk.yellow,\n  deleted: chalk.gray,\n  error: chalk.red,\n}\n\nexport function formatBytes(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`\n  if (bytes < 1024 ** 2) return `${(bytes / 1024).toFixed(1)} KB`\n  if (bytes < 1024 ** 3) return `${(bytes / 1024 ** 2).toFixed(1)} MB`\n  if (bytes < 1024 ** 4) return `${(bytes / 1024 ** 3).toFixed(1)} GB`\n  return `${(bytes / 1024 ** 4).toFixed(1)} TB`\n}\n\nexport function formatStatus(status: DatalakeStatus): string {\n  const colorize = STATUS_COLORS[status] ?? chalk.white\n  return colorize(status)\n}\n\nexport function printDatalakeRow(datalake: DatalakeDescriptor): void {\n  const size = datalake.config.sizeBytes ? formatBytes(datalake.config.sizeBytes) : '—'\n  const name = chalk.white(datalake.name.padEnd(20))\n  const tier = chalk.cyan(datalake.config.tier.padEnd(8))\n  const region = chalk.gray((datalake.config.region ?? '—').padEnd(12))\n  const status = formatStatus(datalake.status).padEnd(14)\n  console.log(`  ${name} ${tier} ${region} ${size.padStart(8)}  ${status}`)\n}\n\nfunction printRateLimits(limits: RateLimitOverrides): void {\n  const parts: string[] = []\n  if (limits.authenticatedPerMinute !== undefined) parts.push(`auth=${limits.authenticatedPerMinute}/min`)\n  if (limits.anonymousPerMinute !== undefined) parts.push(`anon=${limits.anonymousPerMinute}/min`)\n  if (limits.burstFactor !== undefined) parts.push(`burst=${limits.burstFactor}x`)\n  if (parts.length > 0) {\n    console.log(`  ${chalk.gray('limits:')}     ${parts.join(' ')}`)\n  }\n}\n\nfunction printUsage(usage: DatalakeUsage): void {\n  console.log()\n  console.log(chalk.cyan('  usage'))\n  console.log(`    ${chalk.gray('payloads:')}   ${usage.payloadCount}`)\n  console.log(`    ${chalk.gray('stored:')}     ${formatBytes(usage.bytesStored)} / ${formatBytes(usage.bytesStoredLimit)}`)\n  console.log(`    ${chalk.gray('reads 24h:')}  ${usage.readsLast24h}`)\n  console.log(`    ${chalk.gray('writes 24h:')} ${usage.writesLast24h}`)\n}\n\nfunction printAcl(acl: DatalakeDescriptor['acl']): void {\n  if (acl.length === 0) return\n  console.log()\n  console.log(chalk.cyan('  access'))\n  for (const entry of acl) {\n    const principal = entry.principal === 'public' ? chalk.yellow('public') : entry.principal\n    console.log(`    ${principal.padEnd(24)} ${chalk.magenta(entry.role)}  ${chalk.gray(entry.grantedAt)}`)\n  }\n}\n\nexport function printDatalakeDetail(datalake: DatalakeDescriptor): void {\n  console.log(chalk.cyan(`\\n${datalake.name}`))\n  console.log(`  ${chalk.gray('id:')}         ${datalake.id}`)\n  console.log(`  ${chalk.gray('status:')}     ${formatStatus(datalake.status)}`)\n  if (datalake.url) {\n    console.log(`  ${chalk.gray('url:')}        ${datalake.url}`)\n  }\n  console.log(`  ${chalk.gray('owner:')}      ${datalake.ownerId}`)\n  console.log(`  ${chalk.gray('tier:')}       ${datalake.config.tier}`)\n  console.log(`  ${chalk.gray('region:')}     ${datalake.config.region ?? '—'}`)\n  console.log(`  ${chalk.gray('size:')}       ${datalake.config.sizeBytes ? formatBytes(datalake.config.sizeBytes) : '—'}`)\n  console.log(`  ${chalk.gray('iops:')}       ${datalake.config.iops ?? '—'}`)\n  console.log(`  ${chalk.gray('retention:')}  ${datalake.config.retentionDays ?? 'forever'}`)\n  if (datalake.config.verifyHashes) {\n    console.log(`  ${chalk.gray('verify:')}     ${chalk.green('hashes enforced')}`)\n  }\n  if (datalake.config.rateLimits) printRateLimits(datalake.config.rateLimits)\n  console.log(`  ${chalk.gray('created:')}    ${datalake.createdAt}`)\n  console.log(`  ${chalk.gray('updated:')}    ${datalake.updatedAt}`)\n  if (datalake.usage) printUsage(datalake.usage)\n  printAcl(datalake.acl)\n  if (datalake.errorMessage) {\n    console.log()\n    console.log(`  ${chalk.red('error:')} ${datalake.errorMessage}`)\n  }\n}\n","import { getDefaultDatalake } from '@xylabs/aries-datalake-client'\n\n/**\n * Resolves the target datalake name/id for commands that take an optional\n * argument. Falls back to the one set via `aries datalake use`.\n */\nexport function resolveTarget(argValue: string | undefined): string {\n  const target = argValue ?? getDefaultDatalake()\n  if (!target) {\n    throw new Error(\n      'No datalake specified and no default set. '\n      + 'Pass <name> or run `aries datalake use <name>`.',\n    )\n  }\n  return target\n}\n","import { createDatalakeClient } from '@xylabs/aries-datalake-client'\nimport type { DatalakePrincipal, DatalakeRole } from '@xylabs/aries-datalake-core'\nimport chalk from 'chalk'\n\nimport { printDatalakeDetail } from './formatters.ts'\nimport { resolveTarget } from './resolveTarget.ts'\n\nexport interface GrantAccessOptions {\n  idOrName?: string\n  principal: DatalakePrincipal\n  role: DatalakeRole\n  confirmPublic?: boolean\n}\n\nexport async function grantAccess(options: GrantAccessOptions): Promise<void> {\n  const client = createDatalakeClient()\n  const target = resolveTarget(options.idOrName)\n\n  if (options.principal === 'public' && options.role === 'runner' && !options.confirmPublic) {\n    console.log(chalk.yellow(\n      'Granting `public runner` makes anonymous writes possible. '\n      + 'Re-run with --confirm-public to proceed.',\n    ))\n    process.exitCode = 1\n    return\n  }\n\n  const descriptor = await client.describe(target)\n  const updated = await client.grant({\n    datalakeId: descriptor.id,\n    principal: options.principal,\n    role: options.role,\n  })\n  console.log(chalk.green(`granted ${options.role} to ${options.principal} on ${updated.name}`))\n  printDatalakeDetail(updated)\n}\n","import type { DatalakeRole } from '@xylabs/aries-datalake-core'\nimport type { CommandModule } from 'yargs'\n\nimport { grantAccess } from '../actions/datalake/index.ts'\n\nexport const datalakeGrantCommand: CommandModule = {\n  command: 'grant <name> <principal>',\n  describe: 'Grant a role on a datalake (principal=user-id or \"public\")',\n  builder: yargs =>\n    yargs\n      .positional('name', {\n        type: 'string',\n        describe: 'Datalake name or id',\n        demandOption: true,\n      })\n      .positional('principal', {\n        type: 'string',\n        describe: 'User id, or the literal \"public\"',\n        demandOption: true,\n      })\n      .option('role', {\n        alias: 'r',\n        type: 'string',\n        choices: ['viewer', 'runner'] as const,\n        default: 'viewer',\n        describe: 'Role to grant',\n      })\n      .option('confirm-public', {\n        type: 'boolean',\n        default: false,\n        describe: 'Required to grant `public runner` (anonymous writes)',\n      }),\n  handler: async (argv) => {\n    await grantAccess({\n      idOrName: argv.name as string,\n      principal: argv.principal as string,\n      role: argv.role as DatalakeRole,\n      confirmPublic: argv['confirm-public'] as boolean,\n    })\n  },\n}\n"],"mappings":";AAGA,OAAO,WAAW;AAElB,IAAM,gBAA+D;AAAA,EACnE,SAAS,MAAM;AAAA,EACf,cAAc,MAAM;AAAA,EACpB,OAAO,MAAM;AAAA,EACb,UAAU,MAAM;AAAA,EAChB,gBAAgB,MAAM;AAAA,EACtB,SAAS,MAAM;AAAA,EACf,OAAO,MAAM;AACf;AAEO,SAAS,YAAY,OAAuB;AACjD,MAAI,QAAQ,KAAM,QAAO,GAAG,KAAK;AACjC,MAAI,QAAQ,QAAQ,EAAG,QAAO,IAAI,QAAQ,MAAM,QAAQ,CAAC,CAAC;AAC1D,MAAI,QAAQ,QAAQ,EAAG,QAAO,IAAI,QAAQ,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAC/D,MAAI,QAAQ,QAAQ,EAAG,QAAO,IAAI,QAAQ,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAC/D,SAAO,IAAI,QAAQ,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAC1C;AAEO,SAAS,aAAa,QAAgC;AAC3D,QAAM,WAAW,cAAc,MAAM,KAAK,MAAM;AAChD,SAAO,SAAS,MAAM;AACxB;AAWA,SAAS,gBAAgB,QAAkC;AACzD,QAAM,QAAkB,CAAC;AACzB,MAAI,OAAO,2BAA2B,OAAW,OAAM,KAAK,QAAQ,OAAO,sBAAsB,MAAM;AACvG,MAAI,OAAO,uBAAuB,OAAW,OAAM,KAAK,QAAQ,OAAO,kBAAkB,MAAM;AAC/F,MAAI,OAAO,gBAAgB,OAAW,OAAM,KAAK,SAAS,OAAO,WAAW,GAAG;AAC/E,MAAI,MAAM,SAAS,GAAG;AACpB,YAAQ,IAAI,KAAK,MAAM,KAAK,SAAS,CAAC,QAAQ,MAAM,KAAK,GAAG,CAAC,EAAE;AAAA,EACjE;AACF;AAEA,SAAS,WAAW,OAA4B;AAC9C,UAAQ,IAAI;AACZ,UAAQ,IAAI,MAAM,KAAK,SAAS,CAAC;AACjC,UAAQ,IAAI,OAAO,MAAM,KAAK,WAAW,CAAC,MAAM,MAAM,YAAY,EAAE;AACpE,UAAQ,IAAI,OAAO,MAAM,KAAK,SAAS,CAAC,QAAQ,YAAY,MAAM,WAAW,CAAC,MAAM,YAAY,MAAM,gBAAgB,CAAC,EAAE;AACzH,UAAQ,IAAI,OAAO,MAAM,KAAK,YAAY,CAAC,KAAK,MAAM,YAAY,EAAE;AACpE,UAAQ,IAAI,OAAO,MAAM,KAAK,aAAa,CAAC,IAAI,MAAM,aAAa,EAAE;AACvE;AAEA,SAAS,SAAS,KAAsC;AACtD,MAAI,IAAI,WAAW,EAAG;AACtB,UAAQ,IAAI;AACZ,UAAQ,IAAI,MAAM,KAAK,UAAU,CAAC;AAClC,aAAW,SAAS,KAAK;AACvB,UAAM,YAAY,MAAM,cAAc,WAAW,MAAM,OAAO,QAAQ,IAAI,MAAM;AAChF,YAAQ,IAAI,OAAO,UAAU,OAAO,EAAE,CAAC,IAAI,MAAM,QAAQ,MAAM,IAAI,CAAC,KAAK,MAAM,KAAK,MAAM,SAAS,CAAC,EAAE;AAAA,EACxG;AACF;AAEO,SAAS,oBAAoB,UAAoC;AACtE,UAAQ,IAAI,MAAM,KAAK;AAAA,EAAK,SAAS,IAAI,EAAE,CAAC;AAC5C,UAAQ,IAAI,KAAK,MAAM,KAAK,KAAK,CAAC,YAAY,SAAS,EAAE,EAAE;AAC3D,UAAQ,IAAI,KAAK,MAAM,KAAK,SAAS,CAAC,QAAQ,aAAa,SAAS,MAAM,CAAC,EAAE;AAC7E,MAAI,SAAS,KAAK;AAChB,YAAQ,IAAI,KAAK,MAAM,KAAK,MAAM,CAAC,WAAW,SAAS,GAAG,EAAE;AAAA,EAC9D;AACA,UAAQ,IAAI,KAAK,MAAM,KAAK,QAAQ,CAAC,SAAS,SAAS,OAAO,EAAE;AAChE,UAAQ,IAAI,KAAK,MAAM,KAAK,OAAO,CAAC,UAAU,SAAS,OAAO,IAAI,EAAE;AACpE,UAAQ,IAAI,KAAK,MAAM,KAAK,SAAS,CAAC,QAAQ,SAAS,OAAO,UAAU,QAAG,EAAE;AAC7E,UAAQ,IAAI,KAAK,MAAM,KAAK,OAAO,CAAC,UAAU,SAAS,OAAO,YAAY,YAAY,SAAS,OAAO,SAAS,IAAI,QAAG,EAAE;AACxH,UAAQ,IAAI,KAAK,MAAM,KAAK,OAAO,CAAC,UAAU,SAAS,OAAO,QAAQ,QAAG,EAAE;AAC3E,UAAQ,IAAI,KAAK,MAAM,KAAK,YAAY,CAAC,KAAK,SAAS,OAAO,iBAAiB,SAAS,EAAE;AAC1F,MAAI,SAAS,OAAO,cAAc;AAChC,YAAQ,IAAI,KAAK,MAAM,KAAK,SAAS,CAAC,QAAQ,MAAM,MAAM,iBAAiB,CAAC,EAAE;AAAA,EAChF;AACA,MAAI,SAAS,OAAO,WAAY,iBAAgB,SAAS,OAAO,UAAU;AAC1E,UAAQ,IAAI,KAAK,MAAM,KAAK,UAAU,CAAC,OAAO,SAAS,SAAS,EAAE;AAClE,UAAQ,IAAI,KAAK,MAAM,KAAK,UAAU,CAAC,OAAO,SAAS,SAAS,EAAE;AAClE,MAAI,SAAS,MAAO,YAAW,SAAS,KAAK;AAC7C,WAAS,SAAS,GAAG;AACrB,MAAI,SAAS,cAAc;AACzB,YAAQ,IAAI;AACZ,YAAQ,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,IAAI,SAAS,YAAY,EAAE;AAAA,EACjE;AACF;;;AC3FA,SAAS,0BAA0B;AAM5B,SAAS,cAAc,UAAsC;AAClE,QAAM,SAAS,YAAY,mBAAmB;AAC9C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;;;ACfA,SAAS,4BAA4B;AAErC,OAAOA,YAAW;AAYlB,eAAsB,YAAY,SAA4C;AAC5E,QAAM,SAAS,qBAAqB;AACpC,QAAM,SAAS,cAAc,QAAQ,QAAQ;AAE7C,MAAI,QAAQ,cAAc,YAAY,QAAQ,SAAS,YAAY,CAAC,QAAQ,eAAe;AACzF,YAAQ,IAAIC,OAAM;AAAA,MAChB;AAAA,IAEF,CAAC;AACD,YAAQ,WAAW;AACnB;AAAA,EACF;AAEA,QAAM,aAAa,MAAM,OAAO,SAAS,MAAM;AAC/C,QAAM,UAAU,MAAM,OAAO,MAAM;AAAA,IACjC,YAAY,WAAW;AAAA,IACvB,WAAW,QAAQ;AAAA,IACnB,MAAM,QAAQ;AAAA,EAChB,CAAC;AACD,UAAQ,IAAIA,OAAM,MAAM,WAAW,QAAQ,IAAI,OAAO,QAAQ,SAAS,OAAO,QAAQ,IAAI,EAAE,CAAC;AAC7F,sBAAoB,OAAO;AAC7B;;;AC9BO,IAAM,uBAAsC;AAAA,EACjD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS,WACP,MACG,WAAW,QAAQ;AAAA,IAClB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,cAAc;AAAA,EAChB,CAAC,EACA,WAAW,aAAa;AAAA,IACvB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,cAAc;AAAA,EAChB,CAAC,EACA,OAAO,QAAQ;AAAA,IACd,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS,CAAC,UAAU,QAAQ;AAAA,IAC5B,SAAS;AAAA,IACT,UAAU;AAAA,EACZ,CAAC,EACA,OAAO,kBAAkB;AAAA,IACxB,MAAM;AAAA,IACN,SAAS;AAAA,IACT,UAAU;AAAA,EACZ,CAAC;AAAA,EACL,SAAS,OAAO,SAAS;AACvB,UAAM,YAAY;AAAA,MAChB,UAAU,KAAK;AAAA,MACf,WAAW,KAAK;AAAA,MAChB,MAAM,KAAK;AAAA,MACX,eAAe,KAAK,gBAAgB;AAAA,IACtC,CAAC;AAAA,EACH;AACF;","names":["chalk","chalk"]}

package/dist/commands/datalakeListCommand.mjs

@@ -0,0 +1,61 @@
+// src/actions/datalake/formatters.ts
+import chalk from "chalk";
+var STATUS_COLORS = {
+  pending: chalk.gray,
+  provisioning: chalk.yellow,
+  ready: chalk.green,
+  resizing: chalk.yellow,
+  deprovisioning: chalk.yellow,
+  deleted: chalk.gray,
+  error: chalk.red
+};
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 ** 2) return `${(bytes / 1024).toFixed(1)} KB`;
+  if (bytes < 1024 ** 3) return `${(bytes / 1024 ** 2).toFixed(1)} MB`;
+  if (bytes < 1024 ** 4) return `${(bytes / 1024 ** 3).toFixed(1)} GB`;
+  return `${(bytes / 1024 ** 4).toFixed(1)} TB`;
+}
+function formatStatus(status) {
+  const colorize = STATUS_COLORS[status] ?? chalk.white;
+  return colorize(status);
+}
+function printDatalakeRow(datalake) {
+  const size = datalake.config.sizeBytes ? formatBytes(datalake.config.sizeBytes) : "\u2014";
+  const name = chalk.white(datalake.name.padEnd(20));
+  const tier = chalk.cyan(datalake.config.tier.padEnd(8));
+  const region = chalk.gray((datalake.config.region ?? "\u2014").padEnd(12));
+  const status = formatStatus(datalake.status).padEnd(14);
+  console.log(`  ${name} ${tier} ${region} ${size.padStart(8)}  ${status}`);
+}
+
+// src/actions/datalake/listDatalakes.ts
+import { createDatalakeClient } from "@xylabs/aries-datalake-client";
+import chalk2 from "chalk";
+async function listDatalakes() {
+  const client = createDatalakeClient();
+  const datalakes = await client.list();
+  if (datalakes.length === 0) {
+    console.log(chalk2.yellow("No datalakes yet. Create one with `aries datalake create <name>`."));
+    return;
+  }
+  console.log(
+    chalk2.gray("  ") + chalk2.gray("name".padEnd(20)) + " " + chalk2.gray("tier".padEnd(8)) + " " + chalk2.gray("region".padEnd(12)) + " " + chalk2.gray("    size") + "  " + chalk2.gray("status")
+  );
+  for (const datalake of datalakes) {
+    printDatalakeRow(datalake);
+  }
+}
+
+// src/commands/datalakeListCommand.ts
+var datalakeListCommand = {
+  command: "list",
+  describe: "List your datalakes",
+  handler: async () => {
+    await listDatalakes();
+  }
+};
+export {
+  datalakeListCommand
+};
+//# sourceMappingURL=datalakeListCommand.mjs.map

package/dist/commands/datalakeListCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/datalake/formatters.ts","../../src/actions/datalake/listDatalakes.ts","../../src/commands/datalakeListCommand.ts"],"sourcesContent":["import type {\n  DatalakeDescriptor, DatalakeStatus, DatalakeUsage, RateLimitOverrides,\n} from '@xylabs/aries-datalake-core'\nimport chalk from 'chalk'\n\nconst STATUS_COLORS: Record<DatalakeStatus, (s: string) => string> = {\n  pending: chalk.gray,\n  provisioning: chalk.yellow,\n  ready: chalk.green,\n  resizing: chalk.yellow,\n  deprovisioning: chalk.yellow,\n  deleted: chalk.gray,\n  error: chalk.red,\n}\n\nexport function formatBytes(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`\n  if (bytes < 1024 ** 2) return `${(bytes / 1024).toFixed(1)} KB`\n  if (bytes < 1024 ** 3) return `${(bytes / 1024 ** 2).toFixed(1)} MB`\n  if (bytes < 1024 ** 4) return `${(bytes / 1024 ** 3).toFixed(1)} GB`\n  return `${(bytes / 1024 ** 4).toFixed(1)} TB`\n}\n\nexport function formatStatus(status: DatalakeStatus): string {\n  const colorize = STATUS_COLORS[status] ?? chalk.white\n  return colorize(status)\n}\n\nexport function printDatalakeRow(datalake: DatalakeDescriptor): void {\n  const size = datalake.config.sizeBytes ? formatBytes(datalake.config.sizeBytes) : '—'\n  const name = chalk.white(datalake.name.padEnd(20))\n  const tier = chalk.cyan(datalake.config.tier.padEnd(8))\n  const region = chalk.gray((datalake.config.region ?? '—').padEnd(12))\n  const status = formatStatus(datalake.status).padEnd(14)\n  console.log(`  ${name} ${tier} ${region} ${size.padStart(8)}  ${status}`)\n}\n\nfunction printRateLimits(limits: RateLimitOverrides): void {\n  const parts: string[] = []\n  if (limits.authenticatedPerMinute !== undefined) parts.push(`auth=${limits.authenticatedPerMinute}/min`)\n  if (limits.anonymousPerMinute !== undefined) parts.push(`anon=${limits.anonymousPerMinute}/min`)\n  if (limits.burstFactor !== undefined) parts.push(`burst=${limits.burstFactor}x`)\n  if (parts.length > 0) {\n    console.log(`  ${chalk.gray('limits:')}     ${parts.join(' ')}`)\n  }\n}\n\nfunction printUsage(usage: DatalakeUsage): void {\n  console.log()\n  console.log(chalk.cyan('  usage'))\n  console.log(`    ${chalk.gray('payloads:')}   ${usage.payloadCount}`)\n  console.log(`    ${chalk.gray('stored:')}     ${formatBytes(usage.bytesStored)} / ${formatBytes(usage.bytesStoredLimit)}`)\n  console.log(`    ${chalk.gray('reads 24h:')}  ${usage.readsLast24h}`)\n  console.log(`    ${chalk.gray('writes 24h:')} ${usage.writesLast24h}`)\n}\n\nfunction printAcl(acl: DatalakeDescriptor['acl']): void {\n  if (acl.length === 0) return\n  console.log()\n  console.log(chalk.cyan('  access'))\n  for (const entry of acl) {\n    const principal = entry.principal === 'public' ? chalk.yellow('public') : entry.principal\n    console.log(`    ${principal.padEnd(24)} ${chalk.magenta(entry.role)}  ${chalk.gray(entry.grantedAt)}`)\n  }\n}\n\nexport function printDatalakeDetail(datalake: DatalakeDescriptor): void {\n  console.log(chalk.cyan(`\\n${datalake.name}`))\n  console.log(`  ${chalk.gray('id:')}         ${datalake.id}`)\n  console.log(`  ${chalk.gray('status:')}     ${formatStatus(datalake.status)}`)\n  if (datalake.url) {\n    console.log(`  ${chalk.gray('url:')}        ${datalake.url}`)\n  }\n  console.log(`  ${chalk.gray('owner:')}      ${datalake.ownerId}`)\n  console.log(`  ${chalk.gray('tier:')}       ${datalake.config.tier}`)\n  console.log(`  ${chalk.gray('region:')}     ${datalake.config.region ?? '—'}`)\n  console.log(`  ${chalk.gray('size:')}       ${datalake.config.sizeBytes ? formatBytes(datalake.config.sizeBytes) : '—'}`)\n  console.log(`  ${chalk.gray('iops:')}       ${datalake.config.iops ?? '—'}`)\n  console.log(`  ${chalk.gray('retention:')}  ${datalake.config.retentionDays ?? 'forever'}`)\n  if (datalake.config.verifyHashes) {\n    console.log(`  ${chalk.gray('verify:')}     ${chalk.green('hashes enforced')}`)\n  }\n  if (datalake.config.rateLimits) printRateLimits(datalake.config.rateLimits)\n  console.log(`  ${chalk.gray('created:')}    ${datalake.createdAt}`)\n  console.log(`  ${chalk.gray('updated:')}    ${datalake.updatedAt}`)\n  if (datalake.usage) printUsage(datalake.usage)\n  printAcl(datalake.acl)\n  if (datalake.errorMessage) {\n    console.log()\n    console.log(`  ${chalk.red('error:')} ${datalake.errorMessage}`)\n  }\n}\n","import { createDatalakeClient } from '@xylabs/aries-datalake-client'\nimport chalk from 'chalk'\n\nimport { printDatalakeRow } from './formatters.ts'\n\nexport async function listDatalakes(): Promise<void> {\n  const client = createDatalakeClient()\n  const datalakes = await client.list()\n\n  if (datalakes.length === 0) {\n    console.log(chalk.yellow('No datalakes yet. Create one with `aries datalake create <name>`.'))\n    return\n  }\n\n  console.log(\n    chalk.gray('  ')\n    + chalk.gray('name'.padEnd(20))\n    + ' '\n    + chalk.gray('tier'.padEnd(8))\n    + ' '\n    + chalk.gray('region'.padEnd(12))\n    + ' '\n    + chalk.gray('    size')\n    + '  '\n    + chalk.gray('status'),\n  )\n  for (const datalake of datalakes) {\n    printDatalakeRow(datalake)\n  }\n}\n","import type { CommandModule } from 'yargs'\n\nimport { listDatalakes } from '../actions/datalake/index.ts'\n\nexport const datalakeListCommand: CommandModule = {\n  command: 'list',\n  describe: 'List your datalakes',\n  handler: async () => {\n    await listDatalakes()\n  },\n}\n"],"mappings":";AAGA,OAAO,WAAW;AAElB,IAAM,gBAA+D;AAAA,EACnE,SAAS,MAAM;AAAA,EACf,cAAc,MAAM;AAAA,EACpB,OAAO,MAAM;AAAA,EACb,UAAU,MAAM;AAAA,EAChB,gBAAgB,MAAM;AAAA,EACtB,SAAS,MAAM;AAAA,EACf,OAAO,MAAM;AACf;AAEO,SAAS,YAAY,OAAuB;AACjD,MAAI,QAAQ,KAAM,QAAO,GAAG,KAAK;AACjC,MAAI,QAAQ,QAAQ,EAAG,QAAO,IAAI,QAAQ,MAAM,QAAQ,CAAC,CAAC;AAC1D,MAAI,QAAQ,QAAQ,EAAG,QAAO,IAAI,QAAQ,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAC/D,MAAI,QAAQ,QAAQ,EAAG,QAAO,IAAI,QAAQ,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAC/D,SAAO,IAAI,QAAQ,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAC1C;AAEO,SAAS,aAAa,QAAgC;AAC3D,QAAM,WAAW,cAAc,MAAM,KAAK,MAAM;AAChD,SAAO,SAAS,MAAM;AACxB;AAEO,SAAS,iBAAiB,UAAoC;AACnE,QAAM,OAAO,SAAS,OAAO,YAAY,YAAY,SAAS,OAAO,SAAS,IAAI;AAClF,QAAM,OAAO,MAAM,MAAM,SAAS,KAAK,OAAO,EAAE,CAAC;AACjD,QAAM,OAAO,MAAM,KAAK,SAAS,OAAO,KAAK,OAAO,CAAC,CAAC;AACtD,QAAM,SAAS,MAAM,MAAM,SAAS,OAAO,UAAU,UAAK,OAAO,EAAE,CAAC;AACpE,QAAM,SAAS,aAAa,SAAS,MAAM,EAAE,OAAO,EAAE;AACtD,UAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,SAAS,CAAC,CAAC,KAAK,MAAM,EAAE;AAC1E;;;ACnCA,SAAS,4BAA4B;AACrC,OAAOA,YAAW;AAIlB,eAAsB,gBAA+B;AACnD,QAAM,SAAS,qBAAqB;AACpC,QAAM,YAAY,MAAM,OAAO,KAAK;AAEpC,MAAI,UAAU,WAAW,GAAG;AAC1B,YAAQ,IAAIC,OAAM,OAAO,mEAAmE,CAAC;AAC7F;AAAA,EACF;AAEA,UAAQ;AAAA,IACNA,OAAM,KAAK,IAAI,IACbA,OAAM,KAAK,OAAO,OAAO,EAAE,CAAC,IAC5B,MACAA,OAAM,KAAK,OAAO,OAAO,CAAC,CAAC,IAC3B,MACAA,OAAM,KAAK,SAAS,OAAO,EAAE,CAAC,IAC9B,MACAA,OAAM,KAAK,UAAU,IACrB,OACAA,OAAM,KAAK,QAAQ;AAAA,EACvB;AACA,aAAW,YAAY,WAAW;AAChC,qBAAiB,QAAQ;AAAA,EAC3B;AACF;;;ACzBO,IAAM,sBAAqC;AAAA,EAChD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS,YAAY;AACnB,UAAM,cAAc;AAAA,EACtB;AACF;","names":["chalk","chalk"]}

package/dist/commands/datalakeLoginCommand.mjs

@@ -0,0 +1,39 @@
+// src/actions/datalake/login.ts
+import { saveCredentials } from "@xylabs/aries-datalake-client";
+import chalk from "chalk";
+async function login(options) {
+  const baseUrl = options.baseUrl ?? process.env.ARIES_DATALAKE_API;
+  const token = options.token ?? process.env.ARIES_DATALAKE_TOKEN;
+  if (!baseUrl || !token) {
+    console.log(chalk.yellow(
+      "P0 login requires --base-url and --token (or ARIES_DATALAKE_API + ARIES_DATALAKE_TOKEN). OAuth device-flow lands in P1."
+    ));
+    process.exitCode = 1;
+    return;
+  }
+  saveCredentials({ baseUrl, authToken: token });
+  console.log(chalk.green(`credentials saved for ${baseUrl}`));
+}
+
+// src/commands/datalakeLoginCommand.ts
+var datalakeLoginCommand = {
+  command: "login",
+  describe: "Sign in to the datalake control plane",
+  builder: (yargs) => yargs.option("base-url", {
+    type: "string",
+    describe: "Control-plane base URL (P0: required)"
+  }).option("token", {
+    type: "string",
+    describe: "Pre-issued auth token (P0: required; OAuth lands in P1)"
+  }),
+  handler: async (argv) => {
+    await login({
+      baseUrl: argv["base-url"],
+      token: argv.token
+    });
+  }
+};
+export {
+  datalakeLoginCommand
+};
+//# sourceMappingURL=datalakeLoginCommand.mjs.map

package/dist/commands/datalakeLoginCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/datalake/login.ts","../../src/commands/datalakeLoginCommand.ts"],"sourcesContent":["import { saveCredentials } from '@xylabs/aries-datalake-client'\nimport chalk from 'chalk'\n\nexport interface LoginOptions {\n  baseUrl?: string\n  token?: string\n}\n\n/**\n * P0 stub: accepts a pre-issued token + base URL and writes credentials to\n * disk. The real OAuth device-flow ships in P1 alongside the control plane.\n */\nexport async function login(options: LoginOptions): Promise<void> {\n  const baseUrl = options.baseUrl ?? process.env.ARIES_DATALAKE_API\n  const token = options.token ?? process.env.ARIES_DATALAKE_TOKEN\n\n  if (!baseUrl || !token) {\n    console.log(chalk.yellow(\n      'P0 login requires --base-url and --token (or ARIES_DATALAKE_API + ARIES_DATALAKE_TOKEN). '\n      + 'OAuth device-flow lands in P1.',\n    ))\n    process.exitCode = 1\n    return\n  }\n\n  saveCredentials({ baseUrl, authToken: token })\n  console.log(chalk.green(`credentials saved for ${baseUrl}`))\n}\n","import type { CommandModule } from 'yargs'\n\nimport { login } from '../actions/datalake/index.ts'\n\nexport const datalakeLoginCommand: CommandModule = {\n  command: 'login',\n  describe: 'Sign in to the datalake control plane',\n  builder: yargs =>\n    yargs\n      .option('base-url', {\n        type: 'string',\n        describe: 'Control-plane base URL (P0: required)',\n      })\n      .option('token', {\n        type: 'string',\n        describe: 'Pre-issued auth token (P0: required; OAuth lands in P1)',\n      }),\n  handler: async (argv) => {\n    await login({\n      baseUrl: argv['base-url'] as string | undefined,\n      token: argv.token as string | undefined,\n    })\n  },\n}\n"],"mappings":";AAAA,SAAS,uBAAuB;AAChC,OAAO,WAAW;AAWlB,eAAsB,MAAM,SAAsC;AAChE,QAAM,UAAU,QAAQ,WAAW,QAAQ,IAAI;AAC/C,QAAM,QAAQ,QAAQ,SAAS,QAAQ,IAAI;AAE3C,MAAI,CAAC,WAAW,CAAC,OAAO;AACtB,YAAQ,IAAI,MAAM;AAAA,MAChB;AAAA,IAEF,CAAC;AACD,YAAQ,WAAW;AACnB;AAAA,EACF;AAEA,kBAAgB,EAAE,SAAS,WAAW,MAAM,CAAC;AAC7C,UAAQ,IAAI,MAAM,MAAM,yBAAyB,OAAO,EAAE,CAAC;AAC7D;;;ACvBO,IAAM,uBAAsC;AAAA,EACjD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS,WACP,MACG,OAAO,YAAY;AAAA,IAClB,MAAM;AAAA,IACN,UAAU;AAAA,EACZ,CAAC,EACA,OAAO,SAAS;AAAA,IACf,MAAM;AAAA,IACN,UAAU;AAAA,EACZ,CAAC;AAAA,EACL,SAAS,OAAO,SAAS;AACvB,UAAM,MAAM;AAAA,MACV,SAAS,KAAK,UAAU;AAAA,MACxB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/commands/datalakeLogoutCommand.mjs

@@ -0,0 +1,20 @@
+// src/actions/datalake/logout.ts
+import { clearCredentials } from "@xylabs/aries-datalake-client";
+import chalk from "chalk";
+async function logout() {
+  clearCredentials();
+  console.log(chalk.green("signed out"));
+}
+
+// src/commands/datalakeLogoutCommand.ts
+var datalakeLogoutCommand = {
+  command: "logout",
+  describe: "Clear stored datalake credentials",
+  handler: async () => {
+    await logout();
+  }
+};
+export {
+  datalakeLogoutCommand
+};
+//# sourceMappingURL=datalakeLogoutCommand.mjs.map

package/dist/commands/datalakeLogoutCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/datalake/logout.ts","../../src/commands/datalakeLogoutCommand.ts"],"sourcesContent":["import { clearCredentials } from '@xylabs/aries-datalake-client'\nimport chalk from 'chalk'\n\nexport async function logout(): Promise<void> {\n  clearCredentials()\n  console.log(chalk.green('signed out'))\n}\n","import type { CommandModule } from 'yargs'\n\nimport { logout } from '../actions/datalake/index.ts'\n\nexport const datalakeLogoutCommand: CommandModule = {\n  command: 'logout',\n  describe: 'Clear stored datalake credentials',\n  handler: async () => {\n    await logout()\n  },\n}\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,OAAO,WAAW;AAElB,eAAsB,SAAwB;AAC5C,mBAAiB;AACjB,UAAQ,IAAI,MAAM,MAAM,YAAY,CAAC;AACvC;;;ACFO,IAAM,wBAAuC;AAAA,EAClD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS,YAAY;AACnB,UAAM,OAAO;AAAA,EACf;AACF;","names":[]}

package/dist/commands/datalakePushCommand.mjs

@@ -0,0 +1,214 @@
+// src/actions/datalake/payloads/mintAndConnect.ts
+import { createDatalakeClient, RestPayloadsClient } from "@xylabs/aries-datalake-client";
+import { XyoPayloadsClient } from "@xylabs/aries-datalake-xl1-adapter";
+
+// src/actions/datalake/resolveTarget.ts
+import { getDefaultDatalake } from "@xylabs/aries-datalake-client";
+function resolveTarget(argValue) {
+  const target = argValue ?? getDefaultDatalake();
+  if (!target) {
+    throw new Error(
+      "No datalake specified and no default set. Pass <name> or run `aries datalake use <name>`."
+    );
+  }
+  return target;
+}
+
+// src/actions/datalake/payloads/mintAndConnect.ts
+async function mintAndConnect(options) {
+  const controlClient = createDatalakeClient();
+  const target = resolveTarget(options.idOrName);
+  const descriptor = await controlClient.describe(target);
+  if (!descriptor.url) {
+    throw new Error(`Datalake ${descriptor.name} has no URL yet (status=${descriptor.status})`);
+  }
+  const token = await controlClient.mintToken({
+    datalakeId: descriptor.id,
+    role: options.role,
+    ttlSeconds: options.ttlSeconds ?? 3600
+  });
+  const clientOptions = {
+    baseUrl: token.url,
+    datalakeId: descriptor.id,
+    authToken: token.token
+  };
+  return {
+    client: options.useXl1Sdk ? new XyoPayloadsClient(clientOptions) : new RestPayloadsClient(clientOptions),
+    datalakeName: descriptor.name,
+    datalakeId: descriptor.id,
+    url: token.url,
+    transport: options.useXl1Sdk ? "xl1-sdk" : "native"
+  };
+}
+
+// src/actions/datalake/payloads/parsePayloadsFile.ts
+import { readFileSync } from "fs";
+import path from "path";
+function parsePayloadsFile(filePath) {
+  const absolute = path.resolve(filePath);
+  const raw = readFileSync(absolute, "utf8");
+  const ext = path.extname(absolute).toLowerCase();
+  if (ext === ".jsonl" || ext === ".ndjson") {
+    return parseJsonl(raw);
+  }
+  if (ext === ".json") {
+    return parseJson(raw);
+  }
+  const trimmed = raw.trim();
+  if (trimmed.startsWith("{") && trimmed.endsWith("}") && trimmed.includes("\n{")) {
+    return parseJsonl(raw);
+  }
+  return parseJson(raw);
+}
+function parseJson(raw) {
+  const parsed = JSON.parse(raw);
+  const candidates = Array.isArray(parsed) ? parsed : isPayloadsEnvelope(parsed) ? parsed.payloads : void 0;
+  if (!candidates) {
+    throw new Error('Expected an array of payloads or { "payloads": [...] }');
+  }
+  const result = [];
+  for (const [index, candidate] of candidates.entries()) {
+    validatePayload(candidate, `index ${index}`);
+    result.push(candidate);
+  }
+  return result;
+}
+function parseJsonl(raw) {
+  const lines = raw.split("\n");
+  const payloads = [];
+  for (const [i, line_] of lines.entries()) {
+    const line = line_?.trim();
+    if (!line) continue;
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(`Line ${i + 1}: invalid JSON (${message})`, { cause: error });
+    }
+    validatePayload(parsed, `line ${i + 1}`);
+    payloads.push(parsed);
+  }
+  return payloads;
+}
+function isPayloadsEnvelope(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  return Array.isArray(record.payloads);
+}
+function validatePayload(value, where) {
+  if (typeof value !== "object" || value === null) {
+    throw new Error(`${where}: not an object`);
+  }
+  const record = value;
+  if (typeof record.schema !== "string" || record.schema.length === 0) {
+    throw new Error(`${where}: missing or invalid \`schema\``);
+  }
+  if (typeof record.$hash !== "string" || record.$hash.length === 0) {
+    throw new Error(`${where}: missing or invalid \`$hash\``);
+  }
+}
+
+// src/actions/datalake/payloads/pushPayloads.ts
+import { xyoVerifyPayloadHash } from "@xylabs/aries-datalake-core";
+import chalk from "chalk";
+var DEFAULT_BATCH_SIZE = 500;
+function printRejectedList(label, hashes, cap, color) {
+  console.log(color(label));
+  for (const hash of hashes.slice(0, cap)) {
+    console.log(`  ${hash}`);
+  }
+  if (hashes.length > cap) {
+    console.log(chalk.gray(`  ... and ${hashes.length - cap} more`));
+  }
+}
+async function verifyLocally(payloads) {
+  const mismatches = [];
+  for (const payload of payloads) {
+    if (!await xyoVerifyPayloadHash(payload)) mismatches.push(payload.$hash);
+  }
+  if (mismatches.length === 0) {
+    console.log(chalk.gray(`verified ${payloads.length} payload hashes locally (XL1-canonical)`));
+    return true;
+  }
+  printRejectedList(
+    `refusing to push: ${mismatches.length} payload(s) have mismatched $hash`,
+    mismatches,
+    10,
+    chalk.red
+  );
+  process.exitCode = 1;
+  return false;
+}
+async function pushPayloads(options) {
+  const payloads = parsePayloadsFile(options.file);
+  if (payloads.length === 0) {
+    console.log(chalk.yellow(`${options.file} contained 0 payloads \u2014 nothing to push`));
+    return;
+  }
+  if (options.verify && !await verifyLocally(payloads)) return;
+  const connection = await mintAndConnect({
+    idOrName: options.idOrName,
+    role: "runner",
+    useXl1Sdk: options.xl1Sdk
+  });
+  console.log(chalk.gray(
+    `pushing ${payloads.length} payloads to ${connection.datalakeName} (${connection.datalakeId}) via ${connection.transport}...`
+  ));
+  const batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
+  let inserted = 0;
+  let duplicates = 0;
+  const rejected = [];
+  for (let offset = 0; offset < payloads.length; offset += batchSize) {
+    const batch = payloads.slice(offset, offset + batchSize);
+    const result = await connection.client.insert(batch);
+    inserted += result.inserted;
+    duplicates += result.duplicates;
+    rejected.push(...result.rejected);
+  }
+  console.log(chalk.green(
+    `push complete: inserted=${inserted} duplicates=${duplicates} rejected=${rejected.length}`
+  ));
+  if (rejected.length > 0) {
+    printRejectedList("rejected hashes:", rejected, 20, chalk.yellow);
+  }
+}
+
+// src/commands/datalakePushCommand.ts
+var datalakePushCommand = {
+  command: "push <file> [name]",
+  describe: "Insert payloads from a JSON or JSONL file into a datalake",
+  builder: (yargs) => yargs.positional("file", {
+    type: "string",
+    describe: "Path to a .json (array) or .jsonl (one payload per line) file",
+    demandOption: true
+  }).positional("name", {
+    type: "string",
+    describe: "Target datalake name or id (defaults to current)"
+  }).option("batch-size", {
+    type: "number",
+    default: 500,
+    describe: "Max payloads per HTTP request"
+  }).option("verify", {
+    type: "boolean",
+    default: false,
+    describe: "Verify each payload's $hash against content locally before pushing"
+  }).option("xl1-sdk", {
+    type: "boolean",
+    default: false,
+    describe: "Use the real @xyo-network/xl1-protocol-sdk RestDataLakeRunner"
+  }),
+  handler: async (argv) => {
+    await pushPayloads({
+      file: argv.file,
+      idOrName: argv.name,
+      batchSize: argv["batch-size"],
+      verify: argv.verify,
+      xl1Sdk: argv["xl1-sdk"]
+    });
+  }
+};
+export {
+  datalakePushCommand
+};
+//# sourceMappingURL=datalakePushCommand.mjs.map