@flighthq/audio 0.1.0

package/dist/audioFormat.d.ts

@@ -0,0 +1,2 @@
+export declare function inferAudioType(url: string): string | null;
+//# sourceMappingURL=audioFormat.d.ts.map

package/dist/audioFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioFormat.d.ts","sourceRoot":"","sources":["../src/audioFormat.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBzD"}

package/dist/audioFormat.js

@@ -0,0 +1,22 @@
+export function inferAudioType(url) {
+    const ext = url.split('?')[0].split('.').pop()?.toLowerCase();
+    switch (ext) {
+        case 'mp3':
+            return 'audio/mpeg';
+        case 'ogg':
+            return 'audio/ogg';
+        case 'wav':
+            return 'audio/wav';
+        case 'aac':
+            return 'audio/aac';
+        case 'flac':
+            return 'audio/flac';
+        case 'webm':
+            return 'audio/webm';
+        case 'm4a':
+            return 'audio/mp4';
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=audioFormat.js.map

package/dist/audioFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioFormat.js","sourceRoot":"","sources":["../src/audioFormat.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IAC9D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/audioResource.d.ts

@@ -0,0 +1,3 @@
+import type { AudioResource } from '@flighthq/types';
+export declare function createAudioResource(buffer?: AudioBuffer): AudioResource;
+//# sourceMappingURL=audioResource.d.ts.map

package/dist/audioResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioResource.d.ts","sourceRoot":"","sources":["../src/audioResource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAEvE"}

package/dist/audioResource.js

@@ -0,0 +1,4 @@
+export function createAudioResource(buffer) {
+    return { buffer: buffer ?? null };
+}
+//# sourceMappingURL=audioResource.js.map

package/dist/audioResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioResource.js","sourceRoot":"","sources":["../src/audioResource.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/audioResourceFrom.d.ts

@@ -0,0 +1,4 @@
+import type { AudioResource, AudioResourceUrl } from '@flighthq/types';
+export declare function loadAudioResourceFromUrl(context: AudioContext, url: string, signal?: AbortSignal): Promise<AudioResource>;
+export declare function loadAudioResourceFromUrls(context: AudioContext, sources: AudioResourceUrl[], signal?: AbortSignal): Promise<AudioResource>;
+//# sourceMappingURL=audioResourceFrom.d.ts.map

package/dist/audioResourceFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioResourceFrom.d.ts","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKvE,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAKxB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAKxB"}

package/dist/audioResourceFrom.js

@@ -0,0 +1,16 @@
+import { inferAudioType } from './audioFormat';
+import { createAudioResource } from './audioResource';
+export async function loadAudioResourceFromUrl(context, url, signal) {
+    const response = await fetch(url, { signal });
+    const arrayBuffer = await response.arrayBuffer();
+    const audioBuffer = await context.decodeAudioData(arrayBuffer);
+    return createAudioResource(audioBuffer);
+}
+export async function loadAudioResourceFromUrls(context, sources, signal) {
+    const probe = new Audio();
+    const selected = sources.find(({ url, type }) => probe.canPlayType(type ?? inferAudioType(url) ?? '') !== '');
+    if (selected === undefined)
+        return createAudioResource();
+    return loadAudioResourceFromUrl(context, selected.url, signal);
+}
+//# sourceMappingURL=audioResourceFrom.js.map

package/dist/audioResourceFrom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioResourceFrom.js","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAqB,EACrB,GAAW,EACX,MAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/D,OAAO,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAqB,EACrB,OAA2B,EAC3B,MAAoB;IAEpB,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9G,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,mBAAmB,EAAE,CAAC;IACzD,OAAO,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './audioFormat';
+export * from './audioResource';
+export * from './audioResourceFrom';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './audioFormat';
+export * from './audioResource';
+export * from './audioResourceFrom';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@flighthq/audio",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Audio resources, URL constructors, and the shared audio context",
+  "sideEffects": false
+}

package/src/audioFormat.test.ts

@@ -0,0 +1,43 @@
+import { inferAudioType } from './audioFormat';
+
+describe('inferAudioType', () => {
+  it('returns "audio/mpeg" for .mp3 files', () => {
+    expect(inferAudioType('track.mp3')).toBe('audio/mpeg');
+  });
+
+  it('returns "audio/ogg" for .ogg files', () => {
+    expect(inferAudioType('track.ogg')).toBe('audio/ogg');
+  });
+
+  it('returns "audio/wav" for .wav files', () => {
+    expect(inferAudioType('track.wav')).toBe('audio/wav');
+  });
+
+  it('returns "audio/aac" for .aac files', () => {
+    expect(inferAudioType('track.aac')).toBe('audio/aac');
+  });
+
+  it('returns "audio/flac" for .flac files', () => {
+    expect(inferAudioType('track.flac')).toBe('audio/flac');
+  });
+
+  it('returns "audio/webm" for .webm files', () => {
+    expect(inferAudioType('track.webm')).toBe('audio/webm');
+  });
+
+  it('returns "audio/mp4" for .m4a files', () => {
+    expect(inferAudioType('track.m4a')).toBe('audio/mp4');
+  });
+
+  it('returns null for unrecognized extensions', () => {
+    expect(inferAudioType('track.mid')).toBeNull();
+  });
+
+  it('strips query parameters before matching', () => {
+    expect(inferAudioType('track.mp3?cb=1')).toBe('audio/mpeg');
+  });
+
+  it('returns null for a URL with no extension', () => {
+    expect(inferAudioType('audio')).toBeNull();
+  });
+});

package/src/audioResource.test.ts

@@ -0,0 +1,8 @@
+import { createAudioResource } from './audioResource';
+
+describe('createAudioResource', () => {
+  it('returns a resource with null buffer when called with no arguments', () => {
+    const resource = createAudioResource();
+    expect(resource.buffer).toBeNull();
+  });
+});

package/src/audioResourceFrom.test.ts

@@ -0,0 +1,20 @@
+import { loadAudioResourceFromUrl, loadAudioResourceFromUrls } from './audioResourceFrom';
+
+const mockContext = {
+  decodeAudioData: vi.fn().mockResolvedValue({} as AudioBuffer),
+} as unknown as AudioContext;
+
+describe('loadAudioResourceFromUrl', () => {
+  it('returns a Promise', () => {
+    const result = loadAudioResourceFromUrl(mockContext, 'test.mp3');
+    result.catch(() => {});
+    expect(result).toBeInstanceOf(Promise);
+  });
+});
+
+describe('loadAudioResourceFromUrls', () => {
+  it('resolves immediately with a null-buffer resource when sources is empty', async () => {
+    const resource = await loadAudioResourceFromUrls(mockContext, []);
+    expect(resource.buffer).toBeNull();
+  });
+});