@tstdl/base 0.90.65 → 0.90.67

package/api/types.d.ts

@@ -44,7 +44,7 @@ export type ApiEndpointDefinition = {
     /** Root resource path. Overwrites default from {@link ApiDefinition}. */
     rootResource?: string | null;
     /**
-     * sub resource in api
+     * Sub resource in api
      *
      * results in
      * ```ts
@@ -89,7 +89,7 @@ export type ApiEndpoint<T extends ApiDefinition, K extends ApiEndpointKeys<T>> =
 export type ApiEndpointParametersSchema<T extends ApiDefinition, K extends ApiEndpointKeys<T>> = NonUndefinable<ApiEndpoint<T, K>['parameters']>;
 export type ApiEndpointBodySchema<T extends ApiDefinition, K extends ApiEndpointKeys<T>> = NonUndefinable<ApiEndpoint<T, K>['body']>;
 export type ApiEndpointResultSchema<T extends ApiDefinition, K extends ApiEndpointKeys<T>> = NonUndefinable<ApiEndpoint<T, K>['result']>;
-export type ApiBinaryType = typeof Uint8Array | typeof Blob | typeof ReadableStream;
+export type ApiBinaryType = typeof Uint8Array | typeof Blob | typeof ReadableStream<any>;
 export type ApiInputType<T extends SchemaTestable> = T extends ApiBinaryType ? (Uint8Array | Blob | ReadableStream<Uint8Array>) : T extends typeof ServerSentEvents ? ServerSentEventsSource : T extends SchemaTestable ? SchemaOutput<T> : never;
 export type ApiOutputType<T extends SchemaTestable> = T extends typeof ReadableStream ? ReadableStream<Uint8Array> : T extends SchemaTestable ? SchemaOutput<T> : never;
 export type ApiParameters<T extends ApiDefinition, K extends ApiEndpointKeys<T>> = ApiInputType<ApiEndpointParametersSchema<T, K>>;

package/file/index.d.ts

@@ -0,0 +1 @@
+export * from './mime-type.js';

package/file/index.js

@@ -0,0 +1 @@
+export * from './mime-type.js';

package/file/mime-type.d.ts

@@ -0,0 +1,2 @@
+export declare function getMimeType(file: Uint8Array | ReadableStream<Uint8Array>): Promise<string>;
+export declare function getMimeTypeExtension(file: Uint8Array | ReadableStream<Uint8Array>): Promise<string | null>;

package/file/mime-type.js

@@ -0,0 +1,36 @@
+import { dynamicImport } from '../import.js';
+import { decodeTextStream } from '../utils/encoding.js';
+import { readTextStream } from '../utils/stream/stream-reader.js';
+import { isUint8Array } from '../utils/type-guards.js';
+export async function getMimeType(file) {
+    return spawnFileCommand(['--brief', '--mime-type', '-'], file);
+}
+export async function getMimeTypeExtension(file) {
+    const extensions = await spawnFileCommand(['--brief', '--extension', '-'], file);
+    const indexOfSlash = extensions.indexOf('/');
+    const extension = (indexOfSlash > 0) ? extensions.slice(0, indexOfSlash) : extensions;
+    if (extension == '???') {
+        return null;
+    }
+    return extension;
+}
+async function spawnFileCommand(args, file) {
+    const { spawn } = await dynamicImport('node:child_process');
+    const { Readable, Writable } = await dynamicImport('node:stream');
+    const process = spawn('file', args, { stdio: 'pipe' });
+    const stdin = Writable.toWeb(process.stdin);
+    const stdout = Readable.toWeb(process.stdout).pipeThrough(decodeTextStream());
+    if (isUint8Array(file)) {
+        const writer = stdin.getWriter();
+        try {
+            await writer.write(file);
+            await writer.close();
+        }
+        catch { /* File command closes stream as soon as it has the required data */ }
+    }
+    else {
+        await file.pipeTo(stdin);
+    }
+    const output = await readTextStream(stdout);
+    return output.trim();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tstdl/base",
-  "version": "0.90.65",
+  "version": "0.90.67",
   "author": "Patrick Hein",
   "publishConfig": {
     "access": "public"
@@ -43,6 +43,7 @@
     "./distributed-loop": "./distributed-loop/index.js",
     "./enumerable": "./enumerable/index.js",
     "./errors": "./errors/index.js",
+    "./file": "./file/index.js",
     "./function": "./function/index.js",
     "./http": "./http/index.js",
     "./http/node": "./http/server/node/index.js",

package/sse/server-sent-events.d.ts

@@ -1,4 +1,4 @@
-import type { Observable } from 'rxjs';
+import { type Observable } from 'rxjs';
 export declare enum ServerSentEventsState {
     Connecting = 0,
     Open = 1,

package/sse/server-sent-events.js

@@ -1,5 +1,5 @@
 import { NotSupportedError } from '../errors/not-supported.error.js';
-import { distinctUntilChanged, filter, fromEvent, map, merge, ReplaySubject, share, shareReplay, startWith, takeUntil } from 'rxjs';
+import { ReplaySubject, distinctUntilChanged, filter, fromEvent, map, merge, share, shareReplay, startWith, takeUntil } from 'rxjs';
 export var ServerSentEventsState;
 (function (ServerSentEventsState) {
     ServerSentEventsState[ServerSentEventsState["Connecting"] = 0] = "Connecting";

package/utils/stream/stream-reader.d.ts

@@ -7,3 +7,4 @@ export type ReadBinaryStreamOptions = {
     onLengthSubceed?: 'error' | 'close' | 'leave-open';
 };
 export declare function readBinaryStream(iterableOrStream: AnyIterable<ArrayBufferView> | ReadableStream<ArrayBufferView>, { length, onLengthExceed, onLengthSubceed }?: ReadBinaryStreamOptions): Promise<Uint8Array>;
+export declare function readTextStream(iterableOrStream: AnyIterable<string> | ReadableStream<string>): Promise<string>;

package/utils/stream/stream-reader.js

@@ -3,7 +3,7 @@ import { MaxBytesExceededError } from '../../errors/max-bytes-exceeded.error.js'
 import { NotSupportedError } from '../../errors/not-supported.error.js';
 import { concatArrayBufferViews } from '../binary.js';
 import { isDefined, isReadableStream } from '../type-guards.js';
-import { getReadableStreamFromIterable } from './readable-stream-adapter.js';
+import { getReadableStreamFromIterable, getReadableStreamIterable } from './readable-stream-adapter.js';
 import { toBytesStream } from './to-bytes-stream.js';
 // eslint-disable-next-line max-statements
 export async function readBinaryStream(iterableOrStream, { length, onLengthExceed = 'error', onLengthSubceed = 'error' } = {}) {
@@ -76,3 +76,11 @@ export async function readBinaryStream(iterableOrStream, { length, onLengthExcee
     }
     return concatArrayBufferViews(views, Uint8Array, totalLength);
 }
+export async function readTextStream(iterableOrStream) {
+    const iterable = isReadableStream(iterableOrStream) ? getReadableStreamIterable(iterableOrStream) : iterableOrStream;
+    let text = '';
+    for await (const chunk of iterable) {
+        text += chunk;
+    }
+    return text;
+}