@ekanos/cli 0.16.0 → 0.17.1

package/dist/repo/publish.js

@@ -0,0 +1,225 @@
+import { RepoManifestError, describeAvailability, discoverRepo, packageContaining, planRepoOrder, } from '@ekanos/integration-schema/repo';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { buildManifest, escalateForPublish, prepareIntegrationSubmission, readProjectVersion, submitPrepared, } from '../commands/publish.js';
+import { CliError, gateFailedError, preconditionError, usageError, validationError, } from '../errors.js';
+import { EXPERIENCE_NOT_SUPPORTED, gateExperience, packExperience, } from '../experience/publish.js';
+import { packProject } from '../pack.js';
+import { loadProject } from '../project.js';
+import { shortHost } from '../ui.js';
+import { collectAllFindings } from '../validate-findings.js';
+export const PUBLISH_ARTIFACT_DIR = path.join('.ekanos', 'publish');
+const AVAILABILITY_NOTE = 'availability is set by a super admin today; the host does not take it at submission';
+function loadRepo(root) {
+    try {
+        return discoverRepo(root);
+    }
+    catch (error) {
+        if (error instanceof RepoManifestError) {
+            throw validationError(error.message, 'Fix the root ekanos.json: { "kind": "repo", "packages": ["integrations/*", "experiences/*"] }.');
+        }
+        throw error;
+    }
+}
+function select(repo, args) {
+    var _a;
+    var _b;
+    if (args.all && args.names.length > 0) {
+        throw usageError('Pass package names or --all, not both.', 'e.g. "ekanos publish acme-crm" or "ekanos publish --all".');
+    }
+    if (args.names.length > 0)
+        return [...args.names];
+    if (args.all)
+        return [];
+    const here = packageContaining(repo, args.cwd);
+    if (here)
+        return [here.name];
+    throw usageError('This is a repo: say what to publish.', `Name packages ("ekanos publish ${(_b = (_a = repo.packages[0]) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : '<package>'}"), pass --all, or run it from inside a package. Packages: ${repo.packages.map((p) => p.name).join(', ') || '(none yet; "ekanos new integration <slug>")'}.`);
+}
+function artifactName(pkg) {
+    return `${pkg.name}-${pkg.version}`;
+}
+function renderTable(ctx, rows) {
+    return ctx.ui.table(['package', 'kind', 'version', 'availability', 'artifact', 'status'], rows.map((row) => { var _a; return [
+        row.name,
+        row.kind,
+        row.version,
+        row.availability,
+        (_a = row.artifact) !== null && _a !== void 0 ? _a : '-',
+        row.detail ? `${row.status}: ${row.detail}` : row.status,
+    ]; }));
+}
+/** Gate one integration and, when asked, build its artifact. No network. */
+async function checkIntegration(pkg, repoRoot, build) {
+    const row = {
+        name: pkg.name,
+        kind: 'integration',
+        version: pkg.version,
+        availability: describeAvailability(pkg.availability),
+        artifact: null,
+        status: 'ready',
+    };
+    try {
+        readProjectVersion(pkg.dir);
+        const loaded = loadProject(pkg.dir);
+        const findings = escalateForPublish(await collectAllFindings(loaded));
+        const errors = findings.filter((f) => f.severity === 'error');
+        if (errors.length > 0) {
+            return Object.assign(Object.assign({}, row), { status: 'gate failed', detail: `${errors.length} error${errors.length === 1 ? '' : 's'}; run "ekanos validate" in ${pkg.relDir}`, findings });
+        }
+        if (!build)
+            return row;
+        const packed = packProject(loaded.projectDir);
+        const dir = path.join(repoRoot, PUBLISH_ARTIFACT_DIR, artifactName(pkg));
+        fs.rmSync(dir, { recursive: true, force: true });
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, `${artifactName(pkg)}.tgz`), packed.archive);
+        fs.writeFileSync(path.join(dir, 'manifest.json'), `${buildManifest(loaded, packed.files)}\n`);
+        const contract = path.join(pkg.dir, 'contract.json');
+        if (fs.existsSync(contract)) {
+            fs.copyFileSync(contract, path.join(dir, 'contract.json'));
+        }
+        return Object.assign(Object.assign(Object.assign({}, row), { status: 'built', artifact: path.relative(repoRoot, dir).split(path.sep).join('/') }), (findings.length > 0 ? { findings } : {}));
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            return Object.assign(Object.assign({}, row), { status: 'refused', detail: error.message });
+        }
+        throw error;
+    }
+}
+/** Gate one experience and, when asked, build and pack it. No network. */
+async function checkExperience(pkg, repoRoot, build, env) {
+    const row = {
+        name: pkg.name,
+        kind: 'experience',
+        version: pkg.version,
+        availability: describeAvailability(pkg.availability),
+        artifact: null,
+        status: 'ready',
+    };
+    try {
+        const gate = await gateExperience({ dir: pkg.dir, dryRun: true, env });
+        const errors = gate.result.findings.filter((f) => f.severity === 'error');
+        if (errors.length > 0) {
+            return Object.assign(Object.assign({}, row), { status: 'gate failed', detail: `${errors.length} error${errors.length === 1 ? '' : 's'}; run "ekanos check" in ${pkg.relDir}`, findings: gate.result.findings });
+        }
+        if (!build)
+            return row;
+        const dir = path.join(repoRoot, PUBLISH_ARTIFACT_DIR, artifactName(pkg));
+        fs.rmSync(dir, { recursive: true, force: true });
+        const packed = await packExperience(gate, dir);
+        const manifest = path.join(pkg.dir, 'manifest.json');
+        if (fs.existsSync(manifest)) {
+            fs.copyFileSync(manifest, path.join(dir, 'manifest.json'));
+        }
+        return Object.assign(Object.assign({}, row), { version: packed.version, status: 'built', artifact: path.relative(repoRoot, dir).split(path.sep).join('/') });
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            return Object.assign(Object.assign({}, row), { status: 'refused', detail: error.message });
+        }
+        throw error;
+    }
+}
+/**
+ * `ekanos publish [name...] | --all [--dry-run]` in a repo.
+ *
+ * The plan is the selected packages, integrations before the experiences that
+ * use them (a same-repo integration is not an override, so it is ordered
+ * first, never refused). Every package passes its own gate before anything is
+ * sent. `--dry-run` also builds each artifact under `.ekanos/publish/` and
+ * touches no network. A real run submits the integrations in order through the
+ * existing path; the host cannot admit an experience yet, so selected
+ * experiences end the run with that refusal.
+ */
+export async function runRepoPublish(ctx, args) {
+    const repo = loadRepo(args.repoRoot);
+    const names = select(repo, args);
+    const plan = planRepoOrder(repo, names);
+    if (plan.unknown.length > 0) {
+        throw usageError(`No package named ${plan.unknown.map((n) => `"${n}"`).join(', ')} in this repo.`, `Packages: ${repo.packages.map((p) => p.name).join(', ') || '(none)'}.`);
+    }
+    if (args.all && repo.problems.length > 0) {
+        throw validationError(`${repo.problems.length} package${repo.problems.length === 1 ? ' is' : 's are'} unreadable: ${repo.problems.map((p) => `${p.where} (${p.message})`).join('; ')}`, 'Fix or remove them, then re-run "ekanos publish --all".');
+    }
+    if (plan.order.length === 0) {
+        throw preconditionError('This repo has no packages yet.', 'Add one with "ekanos new integration <slug>" or "ekanos new experience <slug>".');
+    }
+    const dryRun = args.publish.dryRun === true;
+    const warnings = plan.unselectedDependencies.map((dep) => `${dep.experience} uses ${dep.integration}, which is in this repo but not in this publish: publish ${dep.integration} first, or make sure it is already published at a compatible version.`);
+    const notes = plan.order.flatMap((pkg) => pkg.kind === 'integration' && pkg.availability
+        ? [
+            `${pkg.name}: ${describeAvailability(pkg.availability)} - ${AVAILABILITY_NOTE}.`,
+        ]
+        : []);
+    if (!ctx.jsonMode) {
+        ctx.log(`${dryRun ? 'Dry run: ' : ''}publishing ${plan.order.length} package${plan.order.length === 1 ? '' : 's'} in this order:`);
+        plan.order.forEach((pkg, index) => ctx.log(`  ${index + 1}. ${pkg.name} (${pkg.kind} ${pkg.version}, ${describeAvailability(pkg.availability)})`));
+        for (const warning of warnings)
+            ctx.warn(`  warning: ${warning}`);
+    }
+    // Gate (and, on a dry run, build) every package before anything is sent.
+    const rows = [];
+    for (const pkg of plan.order) {
+        rows.push(pkg.kind === 'integration'
+            ? await checkIntegration(pkg, repo.root, dryRun)
+            : await checkExperience(pkg, repo.root, dryRun, args.publish.env));
+    }
+    const data = (extra = {}) => (Object.assign({ repo: repo.root, dryRun, order: plan.order.map((p) => p.name), warnings,
+        notes, packages: rows }, extra));
+    const summary = (title) => [title, '', renderTable(ctx, rows), ...notes.map((n) => `note: ${n}`)].join('\n');
+    const failed = rows.filter((row) => row.status === 'gate failed' || row.status === 'refused');
+    if (failed.length > 0) {
+        if (!ctx.jsonMode)
+            ctx.log(summary('Nothing was published.'));
+        return ctx.fail(gateFailedError(`${failed.length} of ${rows.length} package${rows.length === 1 ? '' : 's'} did not pass: ${failed.map((r) => r.name).join(', ')}.`, 'Fix the packages named above (the status column says what), then re-run "ekanos publish". Nothing was submitted.'), data());
+    }
+    if (dryRun) {
+        return ctx.succeed(data({ published: false }), summary(`Dry run: ${rows.length} package${rows.length === 1 ? '' : 's'} built under ${PUBLISH_ARTIFACT_DIR}. Nothing was published.`));
+    }
+    // Real publish: integrations in plan order through the existing path.
+    let stop = null;
+    let host = null;
+    for (const [index, pkg] of plan.order.entries()) {
+        const row = rows[index];
+        if (pkg.kind === 'experience') {
+            row.status = 'not supported by the host';
+            continue;
+        }
+        if (stop) {
+            row.status = 'not attempted';
+            continue;
+        }
+        try {
+            const single = Object.assign(Object.assign({}, args.publish), { dir: pkg.dir });
+            const prepared = await prepareIntegrationSubmission(ctx, single);
+            host = prepared.env.host;
+            const submitted = await submitPrepared(ctx, single, prepared);
+            row.status = 'submitted';
+            row.receipt = submitted.data;
+            if (!ctx.jsonMode)
+                ctx.log(submitted.human);
+        }
+        catch (error) {
+            if (!(error instanceof CliError))
+                throw error;
+            row.status = 'failed';
+            row.detail = error.message;
+            stop = error;
+        }
+    }
+    const hostNote = host ? ` to ${shortHost(host)}` : '';
+    if (stop) {
+        if (!ctx.jsonMode)
+            ctx.log(summary('Publish stopped.'));
+        return ctx.fail(stop, data());
+    }
+    if (rows.some((row) => row.status === 'not supported by the host')) {
+        if (!ctx.jsonMode)
+            ctx.log(summary(`Submitted${hostNote}.`));
+        return ctx.fail(gateFailedError(EXPERIENCE_NOT_SUPPORTED, 'The integrations in this publish were submitted; run "ekanos publish --dry-run" to build and pack the experiences. The host has no admission path for experiences until it ships one.'), data({ published: true }));
+    }
+    return ctx.succeed(data({ published: true }), summary(`Submitted ${rows.length} package${rows.length === 1 ? '' : 's'}${hostNote}.`));
+}
+//# sourceMappingURL=publish.js.map

package/dist/repo/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../src/repo/publish.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Finding } from '@ekanos/integration-schema';\nimport {\n  type RepoDiscovery,\n  type RepoPackage,\n  RepoManifestError,\n  describeAvailability,\n  discoverRepo,\n  packageContaining,\n  planRepoOrder,\n} from '@ekanos/integration-schema/repo';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport {\n  type PublishArgs,\n  buildManifest,\n  escalateForPublish,\n  prepareIntegrationSubmission,\n  readProjectVersion,\n  submitPrepared,\n} from '../commands/publish';\nimport type { CliContext } from '../context';\nimport {\n  CliError,\n  gateFailedError,\n  preconditionError,\n  usageError,\n  validationError,\n} from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport {\n  EXPERIENCE_NOT_SUPPORTED,\n  gateExperience,\n  packExperience,\n} from '../experience/publish';\nimport { packProject } from '../pack';\nimport { loadProject } from '../project';\nimport { shortHost } from '../ui';\nimport { collectAllFindings } from '../validate-findings';\n\nexport const PUBLISH_ARTIFACT_DIR = path.join('.ekanos', 'publish');\n\nexport interface RepoPublishArgs {\n  repoRoot: string;\n  /** Where the command was run: inside a package it narrows the selection. */\n  cwd: string;\n  /** Package names given on the command line. */\n  names: readonly string[];\n  all: boolean;\n  /** The single-project publish arguments, reused for every integration. */\n  publish: PublishArgs;\n}\n\nexport type PackageStatus =\n  | 'ready'\n  | 'built'\n  | 'gate failed'\n  | 'refused'\n  | 'submitted'\n  | 'failed'\n  | 'not attempted'\n  | 'not supported by the host';\n\nexport interface PackageRow {\n  name: string;\n  kind: 'integration' | 'experience';\n  version: string;\n  availability: string;\n  /** Artifact directory relative to the repo root, when one was built. */\n  artifact: string | null;\n  status: PackageStatus;\n  /** Why the status is not a success, one line. */\n  detail?: string;\n  findings?: Finding[];\n  /** Integration submissions: what the host answered. */\n  receipt?: Record<string, unknown>;\n}\n\nconst AVAILABILITY_NOTE =\n  'availability is set by a super admin today; the host does not take it at submission';\n\nfunction loadRepo(root: string): RepoDiscovery {\n  try {\n    return discoverRepo(root);\n  } catch (error) {\n    if (error instanceof RepoManifestError) {\n      throw validationError(\n        error.message,\n        'Fix the root ekanos.json: { \"kind\": \"repo\", \"packages\": [\"integrations/*\", \"experiences/*\"] }.',\n      );\n    }\n    throw error;\n  }\n}\n\nfunction select(repo: RepoDiscovery, args: RepoPublishArgs): string[] {\n  if (args.all && args.names.length > 0) {\n    throw usageError(\n      'Pass package names or --all, not both.',\n      'e.g. \"ekanos publish acme-crm\" or \"ekanos publish --all\".',\n    );\n  }\n  if (args.names.length > 0) return [...args.names];\n  if (args.all) return [];\n  const here = packageContaining(repo, args.cwd);\n  if (here) return [here.name];\n  throw usageError(\n    'This is a repo: say what to publish.',\n    `Name packages (\"ekanos publish ${repo.packages[0]?.name ?? '<package>'}\"), pass --all, or run it from inside a package. Packages: ${repo.packages.map((p) => p.name).join(', ') || '(none yet; \"ekanos new integration <slug>\")'}.`,\n  );\n}\n\nfunction artifactName(pkg: RepoPackage): string {\n  return `${pkg.name}-${pkg.version}`;\n}\n\nfunction renderTable(ctx: CliContext, rows: readonly PackageRow[]): string {\n  return ctx.ui.table(\n    ['package', 'kind', 'version', 'availability', 'artifact', 'status'],\n    rows.map((row) => [\n      row.name,\n      row.kind,\n      row.version,\n      row.availability,\n      row.artifact ?? '-',\n      row.detail ? `${row.status}: ${row.detail}` : row.status,\n    ]),\n  );\n}\n\n/** Gate one integration and, when asked, build its artifact. No network. */\nasync function checkIntegration(\n  pkg: RepoPackage,\n  repoRoot: string,\n  build: boolean,\n): Promise<PackageRow> {\n  const row: PackageRow = {\n    name: pkg.name,\n    kind: 'integration',\n    version: pkg.version,\n    availability: describeAvailability(pkg.availability),\n    artifact: null,\n    status: 'ready',\n  };\n  try {\n    readProjectVersion(pkg.dir);\n    const loaded = loadProject(pkg.dir);\n    const findings = escalateForPublish(await collectAllFindings(loaded));\n    const errors = findings.filter((f) => f.severity === 'error');\n    if (errors.length > 0) {\n      return {\n        ...row,\n        status: 'gate failed',\n        detail: `${errors.length} error${errors.length === 1 ? '' : 's'}; run \"ekanos validate\" in ${pkg.relDir}`,\n        findings,\n      };\n    }\n    if (!build) return row;\n\n    const packed = packProject(loaded.projectDir);\n    const dir = path.join(repoRoot, PUBLISH_ARTIFACT_DIR, artifactName(pkg));\n    fs.rmSync(dir, { recursive: true, force: true });\n    fs.mkdirSync(dir, { recursive: true });\n    fs.writeFileSync(\n      path.join(dir, `${artifactName(pkg)}.tgz`),\n      packed.archive,\n    );\n    fs.writeFileSync(\n      path.join(dir, 'manifest.json'),\n      `${buildManifest(loaded, packed.files)}\\n`,\n    );\n    const contract = path.join(pkg.dir, 'contract.json');\n    if (fs.existsSync(contract)) {\n      fs.copyFileSync(contract, path.join(dir, 'contract.json'));\n    }\n\n    return {\n      ...row,\n      status: 'built',\n      artifact: path.relative(repoRoot, dir).split(path.sep).join('/'),\n      ...(findings.length > 0 ? { findings } : {}),\n    };\n  } catch (error) {\n    if (error instanceof CliError) {\n      return { ...row, status: 'refused', detail: error.message };\n    }\n    throw error;\n  }\n}\n\n/** Gate one experience and, when asked, build and pack it. No network. */\nasync function checkExperience(\n  pkg: RepoPackage,\n  repoRoot: string,\n  build: boolean,\n  env: Record<string, string | undefined>,\n): Promise<PackageRow> {\n  const row: PackageRow = {\n    name: pkg.name,\n    kind: 'experience',\n    version: pkg.version,\n    availability: describeAvailability(pkg.availability),\n    artifact: null,\n    status: 'ready',\n  };\n  try {\n    const gate = await gateExperience({ dir: pkg.dir, dryRun: true, env });\n    const errors = gate.result.findings.filter((f) => f.severity === 'error');\n    if (errors.length > 0) {\n      return {\n        ...row,\n        status: 'gate failed',\n        detail: `${errors.length} error${errors.length === 1 ? '' : 's'}; run \"ekanos check\" in ${pkg.relDir}`,\n        findings: gate.result.findings,\n      };\n    }\n    if (!build) return row;\n\n    const dir = path.join(repoRoot, PUBLISH_ARTIFACT_DIR, artifactName(pkg));\n    fs.rmSync(dir, { recursive: true, force: true });\n    const packed = await packExperience(gate, dir);\n    const manifest = path.join(pkg.dir, 'manifest.json');\n    if (fs.existsSync(manifest)) {\n      fs.copyFileSync(manifest, path.join(dir, 'manifest.json'));\n    }\n\n    return {\n      ...row,\n      version: packed.version,\n      status: 'built',\n      artifact: path.relative(repoRoot, dir).split(path.sep).join('/'),\n    };\n  } catch (error) {\n    if (error instanceof CliError) {\n      return { ...row, status: 'refused', detail: error.message };\n    }\n    throw error;\n  }\n}\n\n/**\n * `ekanos publish [name...] | --all [--dry-run]` in a repo.\n *\n * The plan is the selected packages, integrations before the experiences that\n * use them (a same-repo integration is not an override, so it is ordered\n * first, never refused). Every package passes its own gate before anything is\n * sent. `--dry-run` also builds each artifact under `.ekanos/publish/` and\n * touches no network. A real run submits the integrations in order through the\n * existing path; the host cannot admit an experience yet, so selected\n * experiences end the run with that refusal.\n */\nexport async function runRepoPublish(\n  ctx: CliContext,\n  args: RepoPublishArgs,\n): Promise<ExitCode> {\n  const repo = loadRepo(args.repoRoot);\n  const names = select(repo, args);\n  const plan = planRepoOrder(repo, names);\n\n  if (plan.unknown.length > 0) {\n    throw usageError(\n      `No package named ${plan.unknown.map((n) => `\"${n}\"`).join(', ')} in this repo.`,\n      `Packages: ${repo.packages.map((p) => p.name).join(', ') || '(none)'}.`,\n    );\n  }\n  if (args.all && repo.problems.length > 0) {\n    throw validationError(\n      `${repo.problems.length} package${repo.problems.length === 1 ? ' is' : 's are'} unreadable: ${repo.problems.map((p) => `${p.where} (${p.message})`).join('; ')}`,\n      'Fix or remove them, then re-run \"ekanos publish --all\".',\n    );\n  }\n  if (plan.order.length === 0) {\n    throw preconditionError(\n      'This repo has no packages yet.',\n      'Add one with \"ekanos new integration <slug>\" or \"ekanos new experience <slug>\".',\n    );\n  }\n\n  const dryRun = args.publish.dryRun === true;\n  const warnings = plan.unselectedDependencies.map(\n    (dep) =>\n      `${dep.experience} uses ${dep.integration}, which is in this repo but not in this publish: publish ${dep.integration} first, or make sure it is already published at a compatible version.`,\n  );\n  const notes = plan.order.flatMap((pkg) =>\n    pkg.kind === 'integration' && pkg.availability\n      ? [\n          `${pkg.name}: ${describeAvailability(pkg.availability)} - ${AVAILABILITY_NOTE}.`,\n        ]\n      : [],\n  );\n\n  if (!ctx.jsonMode) {\n    ctx.log(\n      `${dryRun ? 'Dry run: ' : ''}publishing ${plan.order.length} package${plan.order.length === 1 ? '' : 's'} in this order:`,\n    );\n    plan.order.forEach((pkg, index) =>\n      ctx.log(\n        `  ${index + 1}. ${pkg.name} (${pkg.kind} ${pkg.version}, ${describeAvailability(pkg.availability)})`,\n      ),\n    );\n    for (const warning of warnings) ctx.warn(`  warning: ${warning}`);\n  }\n\n  // Gate (and, on a dry run, build) every package before anything is sent.\n  const rows: PackageRow[] = [];\n  for (const pkg of plan.order) {\n    rows.push(\n      pkg.kind === 'integration'\n        ? await checkIntegration(pkg, repo.root, dryRun)\n        : await checkExperience(pkg, repo.root, dryRun, args.publish.env),\n    );\n  }\n\n  const data = (extra: Record<string, unknown> = {}) => ({\n    repo: repo.root,\n    dryRun,\n    order: plan.order.map((p) => p.name),\n    warnings,\n    notes,\n    packages: rows,\n    ...extra,\n  });\n  const summary = (title: string) =>\n    [title, '', renderTable(ctx, rows), ...notes.map((n) => `note: ${n}`)].join(\n      '\\n',\n    );\n\n  const failed = rows.filter(\n    (row) => row.status === 'gate failed' || row.status === 'refused',\n  );\n  if (failed.length > 0) {\n    if (!ctx.jsonMode) ctx.log(summary('Nothing was published.'));\n    return ctx.fail(\n      gateFailedError(\n        `${failed.length} of ${rows.length} package${rows.length === 1 ? '' : 's'} did not pass: ${failed.map((r) => r.name).join(', ')}.`,\n        'Fix the packages named above (the status column says what), then re-run \"ekanos publish\". Nothing was submitted.',\n      ),\n      data(),\n    );\n  }\n\n  if (dryRun) {\n    return ctx.succeed(\n      data({ published: false }),\n      summary(\n        `Dry run: ${rows.length} package${rows.length === 1 ? '' : 's'} built under ${PUBLISH_ARTIFACT_DIR}. Nothing was published.`,\n      ),\n    );\n  }\n\n  // Real publish: integrations in plan order through the existing path.\n  let stop: CliError | null = null;\n  let host: string | null = null;\n  for (const [index, pkg] of plan.order.entries()) {\n    const row = rows[index] as PackageRow;\n    if (pkg.kind === 'experience') {\n      row.status = 'not supported by the host';\n      continue;\n    }\n    if (stop) {\n      row.status = 'not attempted';\n      continue;\n    }\n    try {\n      const single: PublishArgs = { ...args.publish, dir: pkg.dir };\n      const prepared = await prepareIntegrationSubmission(ctx, single);\n      host = prepared.env.host;\n      const submitted = await submitPrepared(ctx, single, prepared);\n      row.status = 'submitted';\n      row.receipt = submitted.data;\n      if (!ctx.jsonMode) ctx.log(submitted.human);\n    } catch (error) {\n      if (!(error instanceof CliError)) throw error;\n      row.status = 'failed';\n      row.detail = error.message;\n      stop = error;\n    }\n  }\n\n  const hostNote = host ? ` to ${shortHost(host)}` : '';\n  if (stop) {\n    if (!ctx.jsonMode) ctx.log(summary('Publish stopped.'));\n    return ctx.fail(stop, data());\n  }\n  if (rows.some((row) => row.status === 'not supported by the host')) {\n    if (!ctx.jsonMode) ctx.log(summary(`Submitted${hostNote}.`));\n    return ctx.fail(\n      gateFailedError(\n        EXPERIENCE_NOT_SUPPORTED,\n        'The integrations in this publish were submitted; run \"ekanos publish --dry-run\" to build and pack the experiences. The host has no admission path for experiences until it ships one.',\n      ),\n      data({ published: true }),\n    );\n  }\n\n  return ctx.succeed(\n    data({ published: true }),\n    summary(\n      `Submitted ${rows.length} package${rows.length === 1 ? '' : 's'}${hostNote}.`,\n    ),\n  );\n}\n"]}

package/dist/repo/scaffold.d.ts

@@ -0,0 +1,30 @@
+import type { CliContext } from '../context.js';
+import type { ExitCode } from '../exit-codes.js';
+export declare const REPO_PACKAGE_GLOBS: readonly ['integrations/*', 'experiences/*'];
+/** Where `ekanos new <kind>` puts a package, relative to the repo root. */
+export declare const REPO_PACKAGE_DIR: {
+    readonly integration: 'integrations';
+    readonly experience: 'experiences';
+};
+export interface InitRepoArgs {
+    slug?: string;
+    dir?: string;
+    cwd: string;
+    force: boolean;
+}
+/** `ekanos init --kind repo`: a root that holds many integrations and experiences. */
+export declare function runInitRepo(ctx: CliContext, args: InitRepoArgs): ExitCode;
+export interface NewPackageArgs {
+    kind: string | undefined;
+    slug: string | undefined;
+    cwd: string;
+    force: boolean;
+    /** Runs the per-kind scaffold; injected by the command to avoid an import cycle with init. */
+    scaffold: (args: {
+        kind: 'integration' | 'experience';
+        slug: string;
+        dir: string;
+    }) => Promise<ExitCode>;
+}
+/** `ekanos new integration|experience <slug>`: scaffold a package into the right folder of the repo. */
+export declare function runNewPackage(ctx: CliContext, args: NewPackageArgs): Promise<ExitCode>;

package/dist/repo/scaffold.js

@@ -0,0 +1,165 @@
+import { discoverRepo, findRepoRoot, matchesPackageGlob, } from '@ekanos/integration-schema/repo';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { invalidStateError, preconditionError, usageError, validationError, } from '../errors.js';
+import { classifyPath, writeFileNoFollow } from '../safe-fs.js';
+import { readTemplateSource } from '../templates.js';
+const SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export const REPO_PACKAGE_GLOBS = ['integrations/*', 'experiences/*'];
+/** Where `ekanos new <kind>` puts a package, relative to the repo root. */
+export const REPO_PACKAGE_DIR = {
+    integration: 'integrations',
+    experience: 'experiences',
+};
+function formatJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+/**
+ * What the repo-root harness shell resolves upward into the root's
+ * node_modules: Next, React and the @ekanos packages. The pins come from the
+ * integration template, so there is one source of truth.
+ */
+const HARNESS_DEV_DEPS = [
+    '@ekanos/cli',
+    '@ekanos/harness',
+    '@tailwindcss/postcss',
+    '@tanstack/react-query',
+    '@types/react',
+    '@types/react-dom',
+    'next',
+    'next-intl',
+    'react',
+    'react-dom',
+    'tailwindcss',
+    'typescript',
+];
+const HARNESS_DEPS = ['@ekanos/sdk', '@ekanos/ui'];
+/** Next type-checks its own config and offers to install this when it is missing. */
+const NODE_TYPES_PIN = '^22.10.0';
+function templatePins(section, names) {
+    const template = JSON.parse(readTemplateSource('package.json.tmpl'));
+    return Object.fromEntries(names.flatMap((name) => {
+        const range = template[section][name];
+        return range ? [[name, range]] : [];
+    }));
+}
+function harnessDevDependencies() {
+    return Object.fromEntries(Object.entries(Object.assign(Object.assign({}, templatePins('devDependencies', HARNESS_DEV_DEPS)), { '@types/node': NODE_TYPES_PIN })).sort(([left], [right]) => left.localeCompare(right)));
+}
+const REPO_GITIGNORE = `# Dependencies
+node_modules/
+
+# Build output
+dist/
+*.tsbuildinfo
+
+# Ekanos dev harness and publish artifacts (generated)
+.ekanos/
+
+# Per-developer integration overrides and credentials
+ekanos.local.json
+
+# Logs
+*.log
+`;
+function repoPnpmWorkspace() {
+    return `${readTemplateSource('pnpm-workspace.yaml.tmpl').trimEnd()}
+
+packages:
+${REPO_PACKAGE_GLOBS.map((glob) => `  - '${glob}'`).join('\n')}
+`;
+}
+/** `ekanos init --kind repo`: a root that holds many integrations and experiences. */
+export function runInitRepo(ctx, args) {
+    var _a;
+    const slug = args.slug;
+    if (slug !== undefined && !SLUG_PATTERN.test(slug)) {
+        throw usageError(`Invalid slug "${slug}".`, 'Use kebab-case, e.g. "ekanos init --kind repo --slug acme-platform".');
+    }
+    if (!slug && args.dir === undefined) {
+        throw usageError('init --kind repo needs a name or a directory.', 'Pass "--slug <name>" (creates ./<name>) or "--dir ." to scaffold in place.');
+    }
+    const targetDir = path.resolve(args.cwd, (_a = args.dir) !== null && _a !== void 0 ? _a : slug);
+    if (fs.existsSync(targetDir) && fs.lstatSync(targetDir).isSymbolicLink()) {
+        throw invalidStateError(`The target directory ${targetDir} is a symlink.`, 'Scaffold into the real directory.');
+    }
+    if (findRepoRoot(targetDir) !== null && !args.force) {
+        throw invalidStateError(`${targetDir} is already inside an Ekanos repo.`, 'Add packages with "ekanos new integration <slug>" or "ekanos new experience <slug>".');
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    const name = slug !== null && slug !== void 0 ? slug : path.basename(targetDir);
+    const files = [
+        {
+            dest: 'ekanos.json',
+            content: formatJson({
+                kind: 'repo',
+                packages: [...REPO_PACKAGE_GLOBS],
+            }),
+        },
+        {
+            dest: 'package.json',
+            content: formatJson({
+                name: SLUG_PATTERN.test(name) ? name : 'ekanos-repo',
+                version: '0.0.0',
+                private: true,
+                type: 'module',
+                description: 'Ekanos integrations and experiences in one repo.',
+                scripts: { dev: 'ekanos dev --start' },
+                dependencies: templatePins('dependencies', HARNESS_DEPS),
+                devDependencies: harnessDevDependencies(),
+            }),
+        },
+        { dest: 'pnpm-workspace.yaml', content: repoPnpmWorkspace() },
+        { dest: '.gitignore', content: REPO_GITIGNORE },
+        { dest: 'integrations/.gitkeep', content: '' },
+        { dest: 'experiences/.gitkeep', content: '' },
+    ];
+    const created = [];
+    const skipped = [];
+    for (const { dest, content } of files) {
+        const destPath = path.join(targetDir, dest);
+        const kind = classifyPath(destPath);
+        if (kind !== 'missing' && kind !== 'symlink' && !args.force) {
+            skipped.push(dest);
+            continue;
+        }
+        writeFileNoFollow(targetDir, destPath, content);
+        created.push(dest);
+    }
+    for (const file of created)
+        ctx.log(`  created ${file}`);
+    for (const file of skipped) {
+        ctx.log(`  skipped ${file} (already exists; --force overwrites)`);
+    }
+    const rel = path.relative(args.cwd, targetDir) || '.';
+    return ctx.succeed({ kind: 'repo', name, dir: targetDir, created, skipped }, `Scaffolded repo "${name}". Next: ${rel === '.' ? '' : `cd ${rel} && `}ekanos new integration <slug> and ekanos new experience <slug>.`);
+}
+/** `ekanos new integration|experience <slug>`: scaffold a package into the right folder of the repo. */
+export async function runNewPackage(ctx, args) {
+    const kind = args.kind;
+    if (kind !== 'integration' && kind !== 'experience') {
+        throw usageError(kind ? `Unknown package kind "${kind}".` : 'new needs a package kind.', 'Use "ekanos new integration <slug>" or "ekanos new experience <slug>".');
+    }
+    const slug = args.slug;
+    if (!slug || !SLUG_PATTERN.test(slug)) {
+        throw usageError(slug ? `Invalid slug "${slug}".` : 'new needs a slug.', `Pass kebab-case, e.g. "ekanos new ${kind} acme-${kind === 'integration' ? 'crm' : 'queue'}".`);
+    }
+    const root = findRepoRoot(args.cwd);
+    if (!root) {
+        throw preconditionError('This directory is not inside an Ekanos repo.', 'Run "ekanos init --kind repo --slug <name>" first, or run this from inside one.');
+    }
+    const repo = discoverRepo(root);
+    const clash = repo.packages.find((pkg) => pkg.name === slug);
+    if (clash) {
+        throw validationError(`"${slug}" is already a ${clash.kind} in this repo (${clash.relDir}).`, 'Pick a different slug; a package is addressed by its slug.');
+    }
+    const dir = path.join(root, REPO_PACKAGE_DIR[kind], slug);
+    const globs = repo.manifest.packages;
+    const rel = path.relative(root, dir).split(path.sep).join('/');
+    const covered = globs.some((glob) => matchesPackageGlob(rel, glob));
+    if (!covered) {
+        throw validationError(`${rel} is not matched by the repo's "packages" globs (${globs.join(', ')}).`, 'Add a glob that covers it to the root ekanos.json, then re-run.');
+    }
+    return args.scaffold({ kind, slug, dir });
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/repo/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/repo/scaffold.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  discoverRepo,\n  findRepoRoot,\n  matchesPackageGlob,\n} from '@ekanos/integration-schema/repo';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport type { CliContext } from '../context';\nimport {\n  invalidStateError,\n  preconditionError,\n  usageError,\n  validationError,\n} from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport { classifyPath, writeFileNoFollow } from '../safe-fs';\nimport { readTemplateSource } from '../templates';\n\nconst SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\n\nexport const REPO_PACKAGE_GLOBS = ['integrations/*', 'experiences/*'] as const;\n\n/** Where `ekanos new <kind>` puts a package, relative to the repo root. */\nexport const REPO_PACKAGE_DIR = {\n  integration: 'integrations',\n  experience: 'experiences',\n} as const;\n\nfunction formatJson(value: unknown): string {\n  return `${JSON.stringify(value, null, 2)}\\n`;\n}\n\n/**\n * What the repo-root harness shell resolves upward into the root's\n * node_modules: Next, React and the @ekanos packages. The pins come from the\n * integration template, so there is one source of truth.\n */\nconst HARNESS_DEV_DEPS = [\n  '@ekanos/cli',\n  '@ekanos/harness',\n  '@tailwindcss/postcss',\n  '@tanstack/react-query',\n  '@types/react',\n  '@types/react-dom',\n  'next',\n  'next-intl',\n  'react',\n  'react-dom',\n  'tailwindcss',\n  'typescript',\n] as const;\n\nconst HARNESS_DEPS = ['@ekanos/sdk', '@ekanos/ui'] as const;\n\n/** Next type-checks its own config and offers to install this when it is missing. */\nconst NODE_TYPES_PIN = '^22.10.0';\n\nfunction templatePins(\n  section: 'dependencies' | 'devDependencies',\n  names: readonly string[],\n): Record<string, string> {\n  const template = JSON.parse(\n    readTemplateSource('package.json.tmpl'),\n  ) as Record<'dependencies' | 'devDependencies', Record<string, string>>;\n\n  return Object.fromEntries(\n    names.flatMap((name) => {\n      const range = template[section][name];\n      return range ? [[name, range] as const] : [];\n    }),\n  );\n}\n\nfunction harnessDevDependencies(): Record<string, string> {\n  return Object.fromEntries(\n    Object.entries({\n      ...templatePins('devDependencies', HARNESS_DEV_DEPS),\n      '@types/node': NODE_TYPES_PIN,\n    }).sort(([left], [right]) => left.localeCompare(right)),\n  );\n}\n\nconst REPO_GITIGNORE = `# Dependencies\nnode_modules/\n\n# Build output\ndist/\n*.tsbuildinfo\n\n# Ekanos dev harness and publish artifacts (generated)\n.ekanos/\n\n# Per-developer integration overrides and credentials\nekanos.local.json\n\n# Logs\n*.log\n`;\n\nfunction repoPnpmWorkspace(): string {\n  return `${readTemplateSource('pnpm-workspace.yaml.tmpl').trimEnd()}\n\npackages:\n${REPO_PACKAGE_GLOBS.map((glob) => `  - '${glob}'`).join('\\n')}\n`;\n}\n\nexport interface InitRepoArgs {\n  slug?: string;\n  dir?: string;\n  cwd: string;\n  force: boolean;\n}\n\n/** `ekanos init --kind repo`: a root that holds many integrations and experiences. */\nexport function runInitRepo(ctx: CliContext, args: InitRepoArgs): ExitCode {\n  const slug = args.slug;\n  if (slug !== undefined && !SLUG_PATTERN.test(slug)) {\n    throw usageError(\n      `Invalid slug \"${slug}\".`,\n      'Use kebab-case, e.g. \"ekanos init --kind repo --slug acme-platform\".',\n    );\n  }\n  if (!slug && args.dir === undefined) {\n    throw usageError(\n      'init --kind repo needs a name or a directory.',\n      'Pass \"--slug <name>\" (creates ./<name>) or \"--dir .\" to scaffold in place.',\n    );\n  }\n\n  const targetDir = path.resolve(args.cwd, args.dir ?? (slug as string));\n  if (fs.existsSync(targetDir) && fs.lstatSync(targetDir).isSymbolicLink()) {\n    throw invalidStateError(\n      `The target directory ${targetDir} is a symlink.`,\n      'Scaffold into the real directory.',\n    );\n  }\n  if (findRepoRoot(targetDir) !== null && !args.force) {\n    throw invalidStateError(\n      `${targetDir} is already inside an Ekanos repo.`,\n      'Add packages with \"ekanos new integration <slug>\" or \"ekanos new experience <slug>\".',\n    );\n  }\n  fs.mkdirSync(targetDir, { recursive: true });\n\n  const name = slug ?? path.basename(targetDir);\n  const files: Array<{ dest: string; content: string }> = [\n    {\n      dest: 'ekanos.json',\n      content: formatJson({\n        kind: 'repo',\n        packages: [...REPO_PACKAGE_GLOBS],\n      }),\n    },\n    {\n      dest: 'package.json',\n      content: formatJson({\n        name: SLUG_PATTERN.test(name) ? name : 'ekanos-repo',\n        version: '0.0.0',\n        private: true,\n        type: 'module',\n        description: 'Ekanos integrations and experiences in one repo.',\n        scripts: { dev: 'ekanos dev --start' },\n        dependencies: templatePins('dependencies', HARNESS_DEPS),\n        devDependencies: harnessDevDependencies(),\n      }),\n    },\n    { dest: 'pnpm-workspace.yaml', content: repoPnpmWorkspace() },\n    { dest: '.gitignore', content: REPO_GITIGNORE },\n    { dest: 'integrations/.gitkeep', content: '' },\n    { dest: 'experiences/.gitkeep', content: '' },\n  ];\n\n  const created: string[] = [];\n  const skipped: string[] = [];\n  for (const { dest, content } of files) {\n    const destPath = path.join(targetDir, dest);\n    const kind = classifyPath(destPath);\n    if (kind !== 'missing' && kind !== 'symlink' && !args.force) {\n      skipped.push(dest);\n      continue;\n    }\n    writeFileNoFollow(targetDir, destPath, content);\n    created.push(dest);\n  }\n\n  for (const file of created) ctx.log(`  created ${file}`);\n  for (const file of skipped) {\n    ctx.log(`  skipped ${file} (already exists; --force overwrites)`);\n  }\n\n  const rel = path.relative(args.cwd, targetDir) || '.';\n\n  return ctx.succeed(\n    { kind: 'repo', name, dir: targetDir, created, skipped },\n    `Scaffolded repo \"${name}\". Next: ${rel === '.' ? '' : `cd ${rel} && `}ekanos new integration <slug> and ekanos new experience <slug>.`,\n  );\n}\n\nexport interface NewPackageArgs {\n  kind: string | undefined;\n  slug: string | undefined;\n  cwd: string;\n  force: boolean;\n  /** Runs the per-kind scaffold; injected by the command to avoid an import cycle with init. */\n  scaffold: (args: {\n    kind: 'integration' | 'experience';\n    slug: string;\n    dir: string;\n  }) => Promise<ExitCode>;\n}\n\n/** `ekanos new integration|experience <slug>`: scaffold a package into the right folder of the repo. */\nexport async function runNewPackage(\n  ctx: CliContext,\n  args: NewPackageArgs,\n): Promise<ExitCode> {\n  const kind = args.kind;\n  if (kind !== 'integration' && kind !== 'experience') {\n    throw usageError(\n      kind ? `Unknown package kind \"${kind}\".` : 'new needs a package kind.',\n      'Use \"ekanos new integration <slug>\" or \"ekanos new experience <slug>\".',\n    );\n  }\n  const slug = args.slug;\n  if (!slug || !SLUG_PATTERN.test(slug)) {\n    throw usageError(\n      slug ? `Invalid slug \"${slug}\".` : 'new needs a slug.',\n      `Pass kebab-case, e.g. \"ekanos new ${kind} acme-${kind === 'integration' ? 'crm' : 'queue'}\".`,\n    );\n  }\n\n  const root = findRepoRoot(args.cwd);\n  if (!root) {\n    throw preconditionError(\n      'This directory is not inside an Ekanos repo.',\n      'Run \"ekanos init --kind repo --slug <name>\" first, or run this from inside one.',\n    );\n  }\n\n  const repo = discoverRepo(root);\n  const clash = repo.packages.find((pkg) => pkg.name === slug);\n  if (clash) {\n    throw validationError(\n      `\"${slug}\" is already a ${clash.kind} in this repo (${clash.relDir}).`,\n      'Pick a different slug; a package is addressed by its slug.',\n    );\n  }\n\n  const dir = path.join(root, REPO_PACKAGE_DIR[kind], slug);\n  const globs = repo.manifest.packages;\n  const rel = path.relative(root, dir).split(path.sep).join('/');\n  const covered = globs.some((glob) => matchesPackageGlob(rel, glob));\n  if (!covered) {\n    throw validationError(\n      `${rel} is not matched by the repo's \"packages\" globs (${globs.join(', ')}).`,\n      'Add a glob that covers it to the root ekanos.json, then re-run.',\n    );\n  }\n\n  return args.scaffold({ kind, slug, dir });\n}\n"]}

package/dist/teams-api.d.ts

@@ -1,4 +1,4 @@
-import { type ProductScopeList, type ProductScopeProductChange, type TeamScopes, type TeamScopesSetResult, type TeamAppSetResult, type TeamCreateRequest, type TeamCreateResult, type TeamDisconnectResult, type TeamMemberChangeResult, type TeamMemberAddResult, type TeamMemberInviteResult, type TeamMemberList, type TeamRenameResult, type TeamRoles, type TeamIntegrationStatus, type TeamIntegrationEventList, type TeamList, type TeamWebhookMintResult } from '@ekanos/integration-schema';
+import { type AudienceCreateRequest, type AudienceListResponse, type AudienceResponse, type AudienceUpdateRequest, type MemberAudience, type MemberAudienceSetResult, type TeamAudience, type TeamAudienceSetResult, type ProductScopeList, type ProductScopeProductChange, type TeamScopes, type TeamScopesSetResult, type TeamAppSetResult, type TeamCreateRequest, type TeamCreateResult, type TeamDisconnectResult, type TeamMemberChangeResult, type TeamMemberAddResult, type TeamMemberInviteResult, type TeamMemberList, type TeamRenameResult, type TeamRoles, type TeamIntegrationStatus, type TeamIntegrationEventList, type TeamList, type TeamWebhookMintResult } from '@ekanos/integration-schema';
 import type { z } from 'zod';
 /**
  * The CLI's client for a Source's teams and their integration setup — the
@@ -22,6 +22,13 @@ import type { z } from 'zod';
  *   GET  /api/partner/scopes?source=<slug>                             → ProductScopeList
  *   PUT | DELETE /api/partner/scopes/<scope>/products/<product>?source=<slug>
  *                                                                      → ProductScopeProductChange
+ *   GET  /api/partner/audiences?source=<slug>                          → AudienceListResponse
+ *   GET | PATCH /api/partner/audiences/<audience>?source=<slug>        → AudienceResponse
+ *   POST /api/partner/audiences?source=<slug>  { name, … }             → AudienceResponse
+ *   GET | PUT /api/partner/teams/<team>/audience?source=<slug>  { audienceId }
+ *                                                                      → TeamAudience | TeamAudienceSetResult
+ *   GET | PUT …/<team>/members/<email>/audience?source=<slug>  { audienceId | null }
+ *                                                                      → MemberAudience | MemberAudienceSetResult
  *   GET  /api/partner/teams/<team>/scopes?source=<slug>                → TeamScopes
  *   PUT  /api/partner/teams/<team>/scopes?source=<slug>  { scopes }   → TeamScopesSetResult
  *
@@ -117,6 +124,35 @@ export declare function setTeamScopes(host: string, accessToken: string, target:
     source: string;
     team: string;
 }, scopes: string[]): Promise<TeamsApiResult<TeamScopesSetResult>>;
+export declare function listAudiences(host: string, accessToken: string, source: string): Promise<TeamsApiResult<AudienceListResponse>>;
+export declare function showAudience(host: string, accessToken: string, target: {
+    source: string;
+    audience: string;
+}): Promise<TeamsApiResult<AudienceResponse>>;
+export declare function createAudience(host: string, accessToken: string, source: string, body: AudienceCreateRequest): Promise<TeamsApiResult<AudienceResponse>>;
+export declare function updateAudience(host: string, accessToken: string, target: {
+    source: string;
+    audience: string;
+}, body: AudienceUpdateRequest): Promise<TeamsApiResult<AudienceResponse>>;
+export declare function showTeamAudience(host: string, accessToken: string, target: {
+    source: string;
+    team: string;
+}): Promise<TeamsApiResult<TeamAudience>>;
+export declare function setTeamAudience(host: string, accessToken: string, target: {
+    source: string;
+    team: string;
+}, audienceId: string): Promise<TeamsApiResult<TeamAudienceSetResult>>;
+export declare function showMemberAudience(host: string, accessToken: string, target: {
+    source: string;
+    team: string;
+    email: string;
+}): Promise<TeamsApiResult<MemberAudience>>;
+/** `audienceId: null` clears the member's own audience. */
+export declare function setMemberAudience(host: string, accessToken: string, target: {
+    source: string;
+    team: string;
+    email: string;
+}, audienceId: string | null): Promise<TeamsApiResult<MemberAudienceSetResult>>;
 export declare function listTeamRoles(host: string, accessToken: string, target: {
     source: string;
     team: string;

package/dist/teams-api.js

@@ -1,4 +1,4 @@
-import { ProductScopeListSchema, ProductScopeProductChangeSchema, TeamScopesSchema, TeamScopesSetResultSchema, TeamAppSetResultSchema, TeamCreateResultSchema, TeamDisconnectResultSchema, TeamMemberChangeResultSchema, TeamMemberAddResultSchema, TeamMemberInviteResultSchema, TeamMemberListSchema, TeamRenameResultSchema, TeamRolesSchema, TeamIntegrationStatusSchema, TeamIntegrationEventListSchema, TeamListSchema, TeamWebhookMintResultSchema, } from '@ekanos/integration-schema';
+import { AudienceListResponseSchema, AudienceResponseSchema, MemberAudienceSchema, MemberAudienceSetResultSchema, TeamAudienceSchema, TeamAudienceSetResultSchema, ProductScopeListSchema, ProductScopeProductChangeSchema, TeamScopesSchema, TeamScopesSetResultSchema, TeamAppSetResultSchema, TeamCreateResultSchema, TeamDisconnectResultSchema, TeamMemberChangeResultSchema, TeamMemberAddResultSchema, TeamMemberInviteResultSchema, TeamMemberListSchema, TeamRenameResultSchema, TeamRolesSchema, TeamIntegrationStatusSchema, TeamIntegrationEventListSchema, TeamListSchema, TeamWebhookMintResultSchema, } from '@ekanos/integration-schema';
 import { request } from './auth/ekanos-api.js';
 import { authRequiredError, forbiddenError, invalidStateError, networkError, notFoundError, usageError, validationError, } from './errors.js';
 export function listTeams(host, accessToken, source) {
@@ -122,6 +122,67 @@ export function setTeamScopes(host, accessToken, target, scopes) {
         body: { scopes },
     });
 }
+export function listAudiences(host, accessToken, source) {
+    return call(host, accessToken, AudienceListResponseSchema, {
+        method: 'GET',
+        path: '/api/partner/audiences',
+        source,
+    });
+}
+export function showAudience(host, accessToken, target) {
+    return call(host, accessToken, AudienceResponseSchema, {
+        method: 'GET',
+        path: `/api/partner/audiences/${encodeURIComponent(target.audience)}`,
+        source: target.source,
+    });
+}
+export function createAudience(host, accessToken, source, body) {
+    return call(host, accessToken, AudienceResponseSchema, {
+        method: 'POST',
+        path: '/api/partner/audiences',
+        source,
+        body,
+    });
+}
+export function updateAudience(host, accessToken, target, body) {
+    return call(host, accessToken, AudienceResponseSchema, {
+        method: 'PATCH',
+        path: `/api/partner/audiences/${encodeURIComponent(target.audience)}`,
+        source: target.source,
+        body,
+    });
+}
+export function showTeamAudience(host, accessToken, target) {
+    return call(host, accessToken, TeamAudienceSchema, {
+        method: 'GET',
+        path: `/api/partner/teams/${encodeURIComponent(target.team)}/audience`,
+        source: target.source,
+    });
+}
+export function setTeamAudience(host, accessToken, target, audienceId) {
+    return call(host, accessToken, TeamAudienceSetResultSchema, {
+        method: 'PUT',
+        path: `/api/partner/teams/${encodeURIComponent(target.team)}/audience`,
+        source: target.source,
+        body: { audienceId },
+    });
+}
+export function showMemberAudience(host, accessToken, target) {
+    return call(host, accessToken, MemberAudienceSchema, {
+        method: 'GET',
+        path: `${membersPath(target.team)}/${encodeURIComponent(target.email)}/audience`,
+        source: target.source,
+    });
+}
+/** `audienceId: null` clears the member's own audience. */
+export function setMemberAudience(host, accessToken, target, audienceId) {
+    return call(host, accessToken, MemberAudienceSetResultSchema, {
+        method: 'PUT',
+        path: `${membersPath(target.team)}/${encodeURIComponent(target.email)}/audience`,
+        source: target.source,
+        body: { audienceId },
+    });
+}
 export function listTeamRoles(host, accessToken, target) {
     return call(host, accessToken, TeamRolesSchema, {
         method: 'GET',