@wirecat/zoom-cli 0.7.0 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/ordinary-file.d.ts +1 -3
- package/dist/ordinary-file.d.ts.map +1 -1
- package/dist/ordinary-file.js +8 -56
- package/dist/ordinary-file.js.map +1 -1
- package/dist/wav-audio.d.ts +1 -27
- package/dist/wav-audio.d.ts.map +1 -1
- package/dist/wav-audio.js +1 -190
- package/dist/wav-audio.js.map +1 -1
- package/package.json +2 -2
package/dist/ordinary-file.d.ts
CHANGED
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
|
|
2
|
-
/** Check the opened object before reading: Windows has no O_NOFOLLOW support. */
|
|
3
|
-
export declare const openOrdinaryFile: (path: string) => Promise<FileHandle>;
|
|
1
|
+
export declare const openOrdinaryFile: (path: string) => Promise<import("fs/promises").FileHandle>;
|
|
4
2
|
export declare const syncDirectory: (path: string) => Promise<void>;
|
|
5
3
|
//# sourceMappingURL=ordinary-file.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ordinary-file.d.ts","sourceRoot":"","sources":["../src/ordinary-file.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"ordinary-file.d.ts","sourceRoot":"","sources":["../src/ordinary-file.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,gBAAgB,SAAU,MAAM,8CAA2C,CAAA;AACxF,eAAO,MAAM,aAAa,SAAU,MAAM,kBAA2C,CAAA"}
|
package/dist/ordinary-file.js
CHANGED
|
@@ -1,64 +1,16 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
1
|
+
import { CliError } from "@wirecat/cli-core";
|
|
2
|
+
import { openOrdinaryFile as sharedOpen, syncDirectory as sharedSync } from "@wirecat/cli-messaging/files";
|
|
3
3
|
import { ZoomError } from "./errors.js";
|
|
4
|
-
|
|
5
|
-
const deviceOf = (dev) => (process.platform === "win32" ? BigInt.asUintN(32, dev) : dev);
|
|
6
|
-
/** Check the opened object before reading: Windows has no O_NOFOLLOW support. */
|
|
7
|
-
export const openOrdinaryFile = async (path) => {
|
|
8
|
-
const before = await lstat(path, { bigint: true });
|
|
9
|
-
if (before.isSymbolicLink())
|
|
10
|
-
throw new ZoomError("validation_error", "archive path must be an ordinary file without a symlink");
|
|
11
|
-
if (!before.isFile())
|
|
12
|
-
throw new ZoomError("validation_error", "archive path must be an ordinary file");
|
|
13
|
-
const flags = process.platform === "win32"
|
|
14
|
-
? constants.O_RDONLY
|
|
15
|
-
: constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0);
|
|
16
|
-
const file = await open(path, flags);
|
|
4
|
+
const withZoomErrors = async (operation) => {
|
|
17
5
|
try {
|
|
18
|
-
|
|
19
|
-
const after = await lstat(path, { bigint: true });
|
|
20
|
-
if (!opened.isFile() || !after.isFile() || before.ino !== opened.ino || before.ino !== after.ino)
|
|
21
|
-
throw new ZoomError("validation_error", "archive file changed while opening");
|
|
22
|
-
if (process.platform === "win32" && before.dev === 0n && after.dev === 0n) {
|
|
23
|
-
// Older Windows path stats omit the device; compare two handles before any content read.
|
|
24
|
-
const witness = await open(path, flags);
|
|
25
|
-
try {
|
|
26
|
-
const identified = await witness.stat({ bigint: true });
|
|
27
|
-
const final = await lstat(path, { bigint: true });
|
|
28
|
-
if (opened.dev === 0n ||
|
|
29
|
-
!identified.isFile() ||
|
|
30
|
-
!final.isFile() ||
|
|
31
|
-
deviceOf(identified.dev) !== deviceOf(opened.dev) ||
|
|
32
|
-
identified.ino !== opened.ino ||
|
|
33
|
-
final.ino !== before.ino ||
|
|
34
|
-
(final.dev !== 0n && deviceOf(final.dev) !== deviceOf(opened.dev)))
|
|
35
|
-
throw new ZoomError("validation_error", "archive file changed while opening");
|
|
36
|
-
}
|
|
37
|
-
finally {
|
|
38
|
-
await witness.close();
|
|
39
|
-
}
|
|
40
|
-
}
|
|
41
|
-
else if (deviceOf(before.dev) !== deviceOf(opened.dev) || deviceOf(before.dev) !== deviceOf(after.dev)) {
|
|
42
|
-
throw new ZoomError("validation_error", "archive file changed while opening");
|
|
43
|
-
}
|
|
44
|
-
return file;
|
|
6
|
+
return await operation();
|
|
45
7
|
}
|
|
46
8
|
catch (error) {
|
|
47
|
-
|
|
9
|
+
if (error instanceof CliError)
|
|
10
|
+
throw new ZoomError(error.code, error.message);
|
|
48
11
|
throw error;
|
|
49
12
|
}
|
|
50
13
|
};
|
|
51
|
-
export const
|
|
52
|
-
|
|
53
|
-
return;
|
|
54
|
-
const directory = await open(path, constants.O_RDONLY | (constants.O_DIRECTORY ?? 0) | (constants.O_NOFOLLOW ?? 0));
|
|
55
|
-
try {
|
|
56
|
-
if (!(await directory.stat()).isDirectory())
|
|
57
|
-
throw new ZoomError("validation_error", "archive publication directory must be ordinary");
|
|
58
|
-
await directory.sync();
|
|
59
|
-
}
|
|
60
|
-
finally {
|
|
61
|
-
await directory.close();
|
|
62
|
-
}
|
|
63
|
-
};
|
|
14
|
+
export const openOrdinaryFile = (path) => withZoomErrors(() => sharedOpen(path));
|
|
15
|
+
export const syncDirectory = (path) => withZoomErrors(() => sharedSync(path));
|
|
64
16
|
//# sourceMappingURL=ordinary-file.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ordinary-file.js","sourceRoot":"","sources":["../src/ordinary-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"ordinary-file.js","sourceRoot":"","sources":["../src/ordinary-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,gBAAgB,IAAI,UAAU,EAAE,aAAa,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAC1G,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,cAAc,GAAG,KAAK,EAAK,SAA2B,EAAc,EAAE;IAC1E,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAA;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAC7E,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;AACxF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA"}
|
package/dist/wav-audio.d.ts
CHANGED
|
@@ -1,28 +1,2 @@
|
|
|
1
|
-
export
|
|
2
|
-
id: string;
|
|
3
|
-
contentHash: string;
|
|
4
|
-
size: number;
|
|
5
|
-
durationMs: number;
|
|
6
|
-
format: "wav";
|
|
7
|
-
sampleRate: 16000 | 48000;
|
|
8
|
-
channels: 1 | 2;
|
|
9
|
-
}
|
|
10
|
-
export interface WavAudioOptions {
|
|
11
|
-
maxBytes: number;
|
|
12
|
-
maxDurationMs: number;
|
|
13
|
-
signal?: AbortSignal;
|
|
14
|
-
}
|
|
15
|
-
export interface WavAudioPlan {
|
|
16
|
-
readonly media: Readonly<WavAudioDescriptor>;
|
|
17
|
-
}
|
|
18
|
-
export interface WavPcmWindow {
|
|
19
|
-
startMs: number;
|
|
20
|
-
endMs: number;
|
|
21
|
-
samples: Float32Array;
|
|
22
|
-
}
|
|
23
|
-
export declare const preflightWavAudio: (path: string, input: WavAudioOptions) => Promise<WavAudioPlan>;
|
|
24
|
-
export declare const openWavAudio: (plan: WavAudioPlan, input: WavAudioOptions) => Promise<{
|
|
25
|
-
windows(): AsyncIterable<WavPcmWindow>;
|
|
26
|
-
close(): Promise<void>;
|
|
27
|
-
}>;
|
|
1
|
+
export { openWavAudio, preflightWavAudio, type WavAudioDescriptor, type WavAudioOptions, type WavAudioPlan, type WavPcmWindow, } from "@wirecat/cli-messaging/speech/wav";
|
|
28
2
|
//# sourceMappingURL=wav-audio.d.ts.map
|
package/dist/wav-audio.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"wav-audio.d.ts","sourceRoot":"","sources":["../src/wav-audio.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"wav-audio.d.ts","sourceRoot":"","sources":["../src/wav-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,mCAAmC,CAAA"}
|
package/dist/wav-audio.js
CHANGED
|
@@ -1,191 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
import { basename, resolve } from "node:path";
|
|
3
|
-
import { checkCancelled, ZoomError } from "./errors.js";
|
|
4
|
-
import { openOrdinaryFile } from "./ordinary-file.js";
|
|
5
|
-
const prepared = new WeakMap();
|
|
6
|
-
const invalid = () => {
|
|
7
|
-
throw new ZoomError("validation_error", "local transcription requires PCM16 mono/stereo WAV at 16 or 48 kHz; convert the media locally to PCM WAV first");
|
|
8
|
-
};
|
|
9
|
-
const validate = (options) => {
|
|
10
|
-
if (!Number.isSafeInteger(options.maxBytes) ||
|
|
11
|
-
options.maxBytes < 1 ||
|
|
12
|
-
options.maxBytes > 4 * 1024 ** 3 ||
|
|
13
|
-
!Number.isSafeInteger(options.maxDurationMs) ||
|
|
14
|
-
options.maxDurationMs < 1 ||
|
|
15
|
-
options.maxDurationMs > 24 * 3600_000)
|
|
16
|
-
throw new ZoomError("validation_error", "audio byte and duration budgets must be positive bounded integers");
|
|
17
|
-
checkCancelled(options.signal);
|
|
18
|
-
};
|
|
19
|
-
const exact = async (file, offset, size, signal) => {
|
|
20
|
-
const bytes = Buffer.alloc(size);
|
|
21
|
-
let read = 0;
|
|
22
|
-
while (read < size) {
|
|
23
|
-
checkCancelled(signal);
|
|
24
|
-
const result = await file.read(bytes, read, size - read, offset + read);
|
|
25
|
-
if (!result.bytesRead)
|
|
26
|
-
throw new ZoomError("validation_error", "WAV changed or was truncated while reading");
|
|
27
|
-
read += result.bytesRead;
|
|
28
|
-
}
|
|
29
|
-
return bytes;
|
|
30
|
-
};
|
|
31
|
-
const layoutOf = async (file, size, options) => {
|
|
32
|
-
if (size < 44 || size > options.maxBytes)
|
|
33
|
-
invalid();
|
|
34
|
-
const header = await exact(file, 0, 12, options.signal);
|
|
35
|
-
if (header.toString("ascii", 0, 4) !== "RIFF" ||
|
|
36
|
-
header.toString("ascii", 8, 12) !== "WAVE" ||
|
|
37
|
-
header.readUInt32LE(4) + 8 !== size)
|
|
38
|
-
invalid();
|
|
39
|
-
let format;
|
|
40
|
-
let data;
|
|
41
|
-
let at = 12;
|
|
42
|
-
let chunks = 0;
|
|
43
|
-
while (at < size) {
|
|
44
|
-
checkCancelled(options.signal);
|
|
45
|
-
if (++chunks > 1024 || size - at < 8)
|
|
46
|
-
invalid();
|
|
47
|
-
const chunk = await exact(file, at, 8, options.signal);
|
|
48
|
-
const kind = chunk.toString("ascii", 0, 4);
|
|
49
|
-
const length = chunk.readUInt32LE(4);
|
|
50
|
-
const start = at + 8;
|
|
51
|
-
const next = start + length + (length % 2);
|
|
52
|
-
if (next > size)
|
|
53
|
-
invalid();
|
|
54
|
-
if (kind === "fmt ") {
|
|
55
|
-
if (format || ![16, 18].includes(length))
|
|
56
|
-
invalid();
|
|
57
|
-
const bytes = await exact(file, start, length, options.signal);
|
|
58
|
-
const channels = bytes.readUInt16LE(2);
|
|
59
|
-
const sampleRate = bytes.readUInt32LE(4);
|
|
60
|
-
if (bytes.readUInt16LE(0) !== 1 ||
|
|
61
|
-
![1, 2].includes(channels) ||
|
|
62
|
-
![16000, 48000].includes(sampleRate) ||
|
|
63
|
-
bytes.readUInt16LE(14) !== 16 ||
|
|
64
|
-
bytes.readUInt16LE(12) !== channels * 2 ||
|
|
65
|
-
bytes.readUInt32LE(8) !== sampleRate * channels * 2 ||
|
|
66
|
-
(length === 18 && bytes.readUInt16LE(16) !== 0))
|
|
67
|
-
invalid();
|
|
68
|
-
format = { sampleRate: sampleRate, channels: channels };
|
|
69
|
-
}
|
|
70
|
-
else if (kind === "data") {
|
|
71
|
-
if (data || !length)
|
|
72
|
-
invalid();
|
|
73
|
-
data = { offset: start, size: length };
|
|
74
|
-
}
|
|
75
|
-
at = next;
|
|
76
|
-
}
|
|
77
|
-
if (!format || !data || data.size % (format.channels * 2) !== 0)
|
|
78
|
-
return invalid();
|
|
79
|
-
const frames = data.size / (format.channels * 2);
|
|
80
|
-
if (Math.ceil((frames * 1000) / format.sampleRate) > options.maxDurationMs)
|
|
81
|
-
throw new ZoomError("validation_error", "WAV exceeds the configured duration limit");
|
|
82
|
-
return { ...format, dataOffset: data.offset, dataSize: data.size, frames };
|
|
83
|
-
};
|
|
84
|
-
const hashRange = async (file, hash, start, end, signal) => {
|
|
85
|
-
let at = start;
|
|
86
|
-
while (at < end) {
|
|
87
|
-
const bytes = await exact(file, at, Math.min(65536, end - at), signal);
|
|
88
|
-
hash.update(bytes);
|
|
89
|
-
at += bytes.length;
|
|
90
|
-
}
|
|
91
|
-
};
|
|
92
|
-
const hashFile = async (file, size, signal) => {
|
|
93
|
-
const hash = createHash("sha256");
|
|
94
|
-
await hashRange(file, hash, 0, size, signal);
|
|
95
|
-
if ((await file.stat()).size !== size)
|
|
96
|
-
throw new ZoomError("validation_error", "WAV changed while verifying its content");
|
|
97
|
-
return hash.digest("hex");
|
|
98
|
-
};
|
|
99
|
-
export const preflightWavAudio = async (path, input) => {
|
|
100
|
-
const options = { ...input };
|
|
101
|
-
validate(options);
|
|
102
|
-
if (typeof path !== "string" || !path.trim() || /\0/.test(path))
|
|
103
|
-
throw new ZoomError("validation_error", "local audio file is required");
|
|
104
|
-
const absolute = resolve(path);
|
|
105
|
-
const file = await openOrdinaryFile(absolute);
|
|
106
|
-
try {
|
|
107
|
-
const stat = await file.stat({ bigint: true });
|
|
108
|
-
const size = Number(stat.size);
|
|
109
|
-
const layout = await layoutOf(file, size, options);
|
|
110
|
-
const contentHash = await hashFile(file, size, options.signal);
|
|
111
|
-
const after = await file.stat({ bigint: true });
|
|
112
|
-
if (stat.size !== after.size || stat.mtimeNs !== after.mtimeNs)
|
|
113
|
-
throw new ZoomError("validation_error", "WAV changed while preparing the transcription");
|
|
114
|
-
const media = Object.freeze({
|
|
115
|
-
id: createHash("sha256").update(basename(absolute)).digest("hex"),
|
|
116
|
-
contentHash,
|
|
117
|
-
size,
|
|
118
|
-
durationMs: Math.ceil((layout.frames * 1000) / layout.sampleRate),
|
|
119
|
-
format: "wav",
|
|
120
|
-
sampleRate: layout.sampleRate,
|
|
121
|
-
channels: layout.channels,
|
|
122
|
-
});
|
|
123
|
-
const plan = Object.freeze({ media });
|
|
124
|
-
prepared.set(plan, { path: absolute, dev: stat.dev, ino: stat.ino, layout });
|
|
125
|
-
return plan;
|
|
126
|
-
}
|
|
127
|
-
finally {
|
|
128
|
-
await file.close();
|
|
129
|
-
}
|
|
130
|
-
};
|
|
131
|
-
export const openWavAudio = async (plan, input) => {
|
|
132
|
-
const options = { ...input };
|
|
133
|
-
validate(options);
|
|
134
|
-
const known = prepared.get(plan);
|
|
135
|
-
if (!known)
|
|
136
|
-
throw new ZoomError("validation_error", "audio plan was not prepared by this adapter");
|
|
137
|
-
const file = await openOrdinaryFile(known.path);
|
|
138
|
-
try {
|
|
139
|
-
const stat = await file.stat({ bigint: true });
|
|
140
|
-
if (stat.dev !== known.dev || stat.ino !== known.ino || Number(stat.size) !== plan.media.size)
|
|
141
|
-
throw new ZoomError("validation_error", "WAV identity changed before transcription");
|
|
142
|
-
const layout = await layoutOf(file, plan.media.size, options);
|
|
143
|
-
if (JSON.stringify(layout) !== JSON.stringify(known.layout) ||
|
|
144
|
-
(await hashFile(file, plan.media.size, options.signal)) !== plan.media.contentHash)
|
|
145
|
-
throw new ZoomError("validation_error", "WAV content changed before transcription");
|
|
146
|
-
let closed = false;
|
|
147
|
-
let consumed = false;
|
|
148
|
-
return {
|
|
149
|
-
async *windows() {
|
|
150
|
-
if (closed || consumed)
|
|
151
|
-
throw new ZoomError("configuration_error", "audio source can be consumed once before closing");
|
|
152
|
-
consumed = true;
|
|
153
|
-
const hash = createHash("sha256");
|
|
154
|
-
await hashRange(file, hash, 0, layout.dataOffset, options.signal);
|
|
155
|
-
const step = layout.sampleRate / 16000;
|
|
156
|
-
for (let frame = 0; frame < layout.frames;) {
|
|
157
|
-
checkCancelled(options.signal);
|
|
158
|
-
const count = Math.min(layout.sampleRate * 30, layout.frames - frame);
|
|
159
|
-
const bytes = await exact(file, layout.dataOffset + frame * layout.channels * 2, count * layout.channels * 2, options.signal);
|
|
160
|
-
hash.update(bytes);
|
|
161
|
-
const samples = new Float32Array(Math.floor(count / step));
|
|
162
|
-
for (let index = 0; index < samples.length; index++) {
|
|
163
|
-
let sum = 0;
|
|
164
|
-
for (let offset = 0; offset < step; offset++)
|
|
165
|
-
for (let channel = 0; channel < layout.channels; channel++)
|
|
166
|
-
sum += bytes.readInt16LE(((index * step + offset) * layout.channels + channel) * 2);
|
|
167
|
-
samples[index] = sum / (32768 * step * layout.channels);
|
|
168
|
-
}
|
|
169
|
-
const startMs = Math.floor((frame * 1000) / layout.sampleRate);
|
|
170
|
-
frame += count;
|
|
171
|
-
if (samples.length)
|
|
172
|
-
yield { startMs, endMs: Math.ceil((frame * 1000) / layout.sampleRate), samples };
|
|
173
|
-
}
|
|
174
|
-
await hashRange(file, hash, layout.dataOffset + layout.dataSize, plan.media.size, options.signal);
|
|
175
|
-
if (hash.digest("hex") !== plan.media.contentHash || (await file.stat()).size !== plan.media.size)
|
|
176
|
-
throw new ZoomError("validation_error", "WAV changed during recognition; no transcript may be stored");
|
|
177
|
-
},
|
|
178
|
-
async close() {
|
|
179
|
-
if (!closed) {
|
|
180
|
-
closed = true;
|
|
181
|
-
await file.close();
|
|
182
|
-
}
|
|
183
|
-
},
|
|
184
|
-
};
|
|
185
|
-
}
|
|
186
|
-
catch (error) {
|
|
187
|
-
await file.close();
|
|
188
|
-
throw error;
|
|
189
|
-
}
|
|
190
|
-
};
|
|
1
|
+
export { openWavAudio, preflightWavAudio, } from "@wirecat/cli-messaging/speech/wav";
|
|
191
2
|
//# sourceMappingURL=wav-audio.js.map
|
package/dist/wav-audio.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"wav-audio.js","sourceRoot":"","sources":["../src/wav-audio.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"wav-audio.js","sourceRoot":"","sources":["../src/wav-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,GAKlB,MAAM,mCAAmC,CAAA"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wirecat/zoom-cli",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.1",
|
|
4
4
|
"description": "Zoom cloud recording archives, persistent transcripts and meeting tools",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"type": "module",
|
|
@@ -53,7 +53,7 @@
|
|
|
53
53
|
"dependencies": {
|
|
54
54
|
"@modelcontextprotocol/sdk": "1.32.1",
|
|
55
55
|
"@wirecat/cli-core": "0.20.0",
|
|
56
|
-
"@wirecat/cli-messaging": "0.
|
|
56
|
+
"@wirecat/cli-messaging": "0.248.0",
|
|
57
57
|
"commander": "15.0.0"
|
|
58
58
|
},
|
|
59
59
|
"devDependencies": {
|