@nebutra/audio-pipeline 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/audio-pipeline",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "BrandContext-first audio generation, license metadata, and loudness utilities",
   "private": false,
   "license": "MIT",
@@ -22,15 +22,19 @@
     "category": "ai",
     "summary": "License-aware BGM, SFX, and song generation surface"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
-    "@nebutra/capability-kit": "0.2.2",
+    "@nebutra/capability-kit": "0.2.4",
     "@nebutra/errors": "0.1.2",
-    "@nebutra/generation-context": "0.1.2"
+    "@nebutra/generation-context": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -51,6 +55,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @nebutra/audio-pipeline@0.1.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/audio-pipeline
-> tsup
-
-CLI Building entry: src/cli.ts, src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/audio-pipeline/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/cli.js                1.32 KB
-ESM dist/index.js              186.00 B
-ESM dist/chunk-32LVUMTP.js     4.46 KB
-ESM dist/index.js.map          71.00 B
-ESM dist/cli.js.map            2.35 KB
-ESM dist/chunk-32LVUMTP.js.map 8.83 KB
-ESM ⚡️ Build success in 31ms
-DTS Build start
-DTS ⚡️ Build success in 2126ms
-DTS dist/cli.d.ts   13.00 B
-DTS dist/index.d.ts 1.47 KB

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @nebutra/audio-pipeline@0.1.1 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/audio-pipeline
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/audio-pipeline
-
- ✓ src/index.test.ts (2 tests) 87ms
-
- Test Files  1 passed (1)
-      Tests  2 passed (2)
-   Start at  09:38:39
-   Duration  1.52s (transform 223ms, setup 0ms, import 285ms, tests 87ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/audio-pipeline@0.1.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/audio-pipeline
-> tsc --noEmit
-

package/examples/bgm.ts

@@ -1,10 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { AudioPipeline } from "../src/index";
-
-const asset = await new AudioPipeline().generate(
-  { type: "bgm", durationS: 5, mood: "uplifting tech", bpm: 110 },
-  createDemoBrandContext(),
-  true,
-);
-
-process.stdout.write(`${asset.path}\n`);

package/examples/license.ts

@@ -1,11 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { AudioPipeline } from "../src/index";
-
-const pipeline = new AudioPipeline();
-const asset = await pipeline.generate(
-  { type: "sfx", description: "keyboard typing", durationS: 2 },
-  createDemoBrandContext(),
-  true,
-);
-
-process.stdout.write(`${JSON.stringify(await pipeline.license(asset), null, 2)}\n`);

package/examples/loudness.ts

@@ -1,11 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { AudioPipeline } from "../src/index";
-
-const pipeline = new AudioPipeline();
-const asset = await pipeline.generate(
-  { type: "song", lyricsPrompt: "indie developer anthem", durationS: 8 },
-  createDemoBrandContext(),
-  true,
-);
-
-process.stdout.write(`${JSON.stringify(await pipeline.loudness(asset), null, 2)}\n`);

package/src/cli.ts

@@ -1,36 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { AudioPipeline, readAudioDebug } from "./index";
-
-const command = process.argv[2] ?? "doctor";
-const pipeline = new AudioPipeline();
-
-if (command === "doctor") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "audio-pipeline", results: await pipeline.doctor() }, null, 2)}\n`,
-  );
-} else if (command === "debug") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "audio-pipeline", entries: await readAudioDebug() }, null, 2)}\n`,
-  );
-} else if (command === "license") {
-  const asset = await pipeline.generate(
-    { type: "bgm", durationS: 3, mood: "uplifting technical" },
-    createDemoBrandContext(),
-    true,
-  );
-  process.stdout.write(
-    `${JSON.stringify({ capability: "audio-pipeline", license: await pipeline.license(asset) }, null, 2)}\n`,
-  );
-} else if (command === "loudness") {
-  const asset = await pipeline.generate(
-    { type: "sfx", description: "keyboard typing", durationS: 1 },
-    createDemoBrandContext(),
-    true,
-  );
-  process.stdout.write(
-    `${JSON.stringify({ capability: "audio-pipeline", loudness: await pipeline.loudness(asset) }, null, 2)}\n`,
-  );
-} else {
-  process.stderr.write(`Unknown audio-pipeline command: ${command}\n`);
-  process.exitCode = 1;
-}

package/src/index.test.ts

@@ -1,33 +0,0 @@
-import { mkdtemp, readFile, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { afterEach, describe, expect, it } from "vitest";
-import { AudioPipeline, readAudioDebug } from "./index";
-
-let root: string | undefined;
-
-afterEach(async () => {
-  if (root) await rm(root, { recursive: true, force: true });
-  root = undefined;
-});
-
-describe("AudioPipeline", () => {
-  it("requires BrandContext", async () => {
-    await expect(
-      new AudioPipeline().generate({ type: "sfx", description: "click" }, undefined, true),
-    ).rejects.toMatchObject({ capability: "audio-pipeline" });
-  });
-
-  it("writes a valid WAV header with commercial metadata", async () => {
-    root = await mkdtemp(join(tmpdir(), "audio-pipeline-"));
-    const asset = await new AudioPipeline({ root }).generate(
-      { type: "bgm", durationS: 4, mood: "calm technical" },
-      createDemoBrandContext(),
-      true,
-    );
-    expect((await readFile(asset.path)).subarray(0, 4).toString()).toBe("RIFF");
-    expect(asset.license.status).toBe("commercial-ok");
-    expect(await readAudioDebug(root)).toHaveLength(1);
-  });
-});

package/src/index.ts

@@ -1,176 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
-import { CapabilityError } from "@nebutra/errors";
-import {
-  assetId,
-  type BrandContext,
-  type GeneratedAsset,
-  type LicenseMetadata,
-  requireBrandContext,
-} from "@nebutra/generation-context";
-
-export type AudioIntent =
-  | { type: "bgm"; durationS: number; mood: string; bpm?: number }
-  | { type: "sfx"; description: string; durationS?: number }
-  | { type: "song"; lyricsPrompt: string; durationS: number };
-
-export interface AudioAsset extends GeneratedAsset {
-  readonly kind: "audio";
-  readonly durationS: number;
-  readonly format: "wav";
-  readonly loudnessLufs: number;
-}
-
-export interface AudioHealth {
-  readonly provider: string;
-  readonly ok: boolean;
-  readonly suggestion?: string;
-}
-
-export interface AudioPipelineOptions {
-  readonly root?: string;
-  readonly provider?: "tone-local" | "local-model" | "remote";
-}
-
-export async function readAudioDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {
-  return readCapabilityDebug("audio-pipeline", { root, limit });
-}
-
-function intentLabel(intent: AudioIntent): string {
-  switch (intent.type) {
-    case "bgm":
-      return intent.mood;
-    case "sfx":
-      return intent.description;
-    case "song":
-      return intent.lyricsPrompt;
-  }
-}
-
-function durationFor(intent: AudioIntent): number {
-  if (intent.type === "sfx") return Math.max(1, Math.min(intent.durationS ?? 3, 8));
-  return Math.max(1, Math.min(intent.durationS, 12));
-}
-
-export function createToneWav(durationS: number, frequency = 440, sampleRate = 24_000): Buffer {
-  const samples = Math.max(1, Math.floor(durationS * sampleRate));
-  const dataBytes = samples * 2;
-  const buffer = Buffer.alloc(44 + dataBytes);
-  buffer.write("RIFF", 0);
-  buffer.writeUInt32LE(36 + dataBytes, 4);
-  buffer.write("WAVE", 8);
-  buffer.write("fmt ", 12);
-  buffer.writeUInt32LE(16, 16);
-  buffer.writeUInt16LE(1, 20);
-  buffer.writeUInt16LE(1, 22);
-  buffer.writeUInt32LE(sampleRate, 24);
-  buffer.writeUInt32LE(sampleRate * 2, 28);
-  buffer.writeUInt16LE(2, 32);
-  buffer.writeUInt16LE(16, 34);
-  buffer.write("data", 36);
-  buffer.writeUInt32LE(dataBytes, 40);
-  for (let index = 0; index < samples; index += 1) {
-    const fade = Math.min(index / 1200, (samples - index) / 1200, 1);
-    const sample = Math.round(
-      Math.sin((2 * Math.PI * frequency * index) / sampleRate) * 9000 * fade,
-    );
-    buffer.writeInt16LE(sample, 44 + index * 2);
-  }
-  return buffer;
-}
-
-function frequencyFor(brand: BrandContext, intent: AudioIntent): number {
-  const base = brand.toneKeywords.join("").length + intentLabel(intent).length;
-  return 220 + (base % 9) * 55;
-}
-
-function licenseFor(requireCommercial: boolean, provider: string): LicenseMetadata {
-  if (requireCommercial && provider !== "tone-local") {
-    return {
-      status: "unknown",
-      source: provider,
-      suggestion: "Verify the provider plan and model terms before commercial use.",
-    };
-  }
-  return { status: "commercial-ok", source: "deterministic local renderer" };
-}
-
-export class AudioPipeline {
-  readonly #root: string;
-  readonly #provider: "tone-local" | "local-model" | "remote";
-
-  constructor(options: AudioPipelineOptions = {}) {
-    this.#root = options.root ?? process.cwd();
-    this.#provider = options.provider ?? "tone-local";
-  }
-
-  async generate(
-    intent: AudioIntent,
-    brandInput: BrandContext | undefined,
-    requireCommercial = true,
-  ): Promise<AudioAsset> {
-    const brand = requireBrandContext(brandInput, "audio-pipeline");
-    if (requireCommercial && this.#provider !== "tone-local") {
-      throw new CapabilityError(
-        "audio-pipeline",
-        "Selected audio provider lacks verified license",
-        {
-          suggestion: "Use tone-local or wire a provider with commercial license metadata.",
-          statusCode: 409,
-        },
-      );
-    }
-    const durationS = durationFor(intent);
-    const id = assetId("audio", `${intent.type}_${intentLabel(intent)}`);
-    const path = join(this.#root, ".nebutra", "generated", "audio-pipeline", `${id}.wav`);
-    await mkdir(dirname(path), { recursive: true });
-    await writeFile(path, createToneWav(durationS, frequencyFor(brand, intent)));
-
-    const asset: AudioAsset = {
-      id,
-      tenantId: brand.tenantId,
-      kind: "audio",
-      path,
-      brandId: brand.brandId,
-      provider: this.#provider,
-      model: "brand-context-tone-v1",
-      createdAt: new Date().toISOString(),
-      license: licenseFor(requireCommercial, this.#provider),
-      durationS,
-      format: "wav",
-      loudnessLufs: -18,
-      metadata: { intent, brandSource: brand.sourcePath },
-    };
-    await appendCapabilityDebug(
-      "audio-pipeline",
-      { type: "generate", asset },
-      { root: this.#root },
-    );
-    return asset;
-  }
-
-  async doctor(): Promise<AudioHealth[]> {
-    return [
-      { provider: "tone-local", ok: true },
-      {
-        provider: "local-model",
-        ok: Boolean(process.env.AUDIO_LOCAL_MODEL_PATH),
-        suggestion: "Set AUDIO_LOCAL_MODEL_PATH to enable local model generation.",
-      },
-      {
-        provider: "remote",
-        ok: Boolean(process.env.AUDIO_REMOTE_API_KEY),
-        suggestion: "Set AUDIO_REMOTE_API_KEY to enable remote audio fallback.",
-      },
-    ];
-  }
-
-  async license(asset: Pick<AudioAsset, "license">): Promise<LicenseMetadata> {
-    return asset.license;
-  }
-
-  async loudness(asset: Pick<AudioAsset, "loudnessLufs">): Promise<{ lufs: number }> {
-    return { lufs: asset.loudnessLufs };
-  }
-}

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "target": "esnext",
-    "types": ["node"],
-    "incremental": false
-  },
-  "include": ["src", "examples"],
-  "exclude": ["node_modules", "dist"]
-}

package/tsup.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts", "src/cli.ts"],
-  format: ["esm"],
-  dts: true,
-  sourcemap: true,
-  clean: true,
-  target: "es2022",
-  external: ["@nebutra/capability-kit/debug", "@nebutra/errors", "@nebutra/generation-context"],
-});