@grest-ts/file 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Grest Games OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/src/GGFile.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Unified file abstraction for Grest framework.
+ * Works across HTTP (multipart), WebSocket (base64), and tests (in-memory).
+ *
+ * Single consumption: buffer()/stream()/text() can only be called once.
+ * Use clone() if multiple reads are needed.
+ */
+export declare abstract class GGFile {
+    abstract readonly name: string;
+    abstract readonly mimeType: string;
+    abstract readonly size: number;
+    /**
+     * Whether the file content has been consumed.
+     * Once consumed, buffer()/stream()/text() will throw.
+     */
+    abstract readonly consumed: boolean;
+    /**
+     * Get the file content as a ReadableStream.
+     * Can only be called once per file instance.
+     * @throws Error if already consumed
+     */
+    abstract stream(): ReadableStream<Uint8Array>;
+    /**
+     * Get the file content as a Uint8Array.
+     * Can only be called once per file instance.
+     * @throws Error if already consumed
+     */
+    abstract buffer(): Promise<Uint8Array>;
+    /**
+     * Get the file content as a UTF-8 string.
+     * Can only be called once per file instance.
+     * @throws Error if already consumed
+     */
+    abstract text(): Promise<string>;
+    /**
+     * Create a copy of this file that can be consumed independently.
+     * Only works if the file hasn't been consumed yet.
+     * @throws Error if already consumed
+     */
+    abstract clone(): GGFile;
+    /**
+     * Create a GGFile from a Uint8Array buffer.
+     */
+    static fromBuffer(data: Uint8Array, name: string, mimeType?: string): GGFile;
+    /**
+     * Create a GGFile from a string (encoded as UTF-8).
+     */
+    static fromString(content: string, name: string, mimeType?: string): GGFile;
+    /**
+     * Create a GGFile from a base64-encoded string.
+     * Used for WebSocket transport where files are sent as base64.
+     */
+    static fromBase64(base64: string, name: string, mimeType?: string): GGFile;
+    /**
+     * Convert a GGFile to base64 string.
+     * Consumes the file.
+     */
+    static toBase64(file: GGFile): Promise<string>;
+    /**
+     * Serialize a GGFile to JSON format for WebSocket transport.
+     * Consumes the file.
+     */
+    static toJSON(file: GGFile): Promise<GGFileJSON>;
+    /**
+     * Deserialize a GGFile from JSON format.
+     */
+    static fromJSON(json: GGFileJSON): GGFile;
+    /**
+     * Check if a value is a serialized GGFile JSON.
+     */
+    static isJSON(value: unknown): value is GGFileJSON;
+    /**
+     * Create a GGFile from a native browser File.
+     * Lazily reads the file content only when buffer()/stream()/text() is called.
+     */
+    static fromBrowserFile(file: File & {
+        readonly name: string;
+    }): GGFile;
+}
+/**
+ * JSON serialization format for GGFile (used in WebSocket transport).
+ */
+export interface GGFileJSON {
+    __ggfile: true;
+    name: string;
+    mimeType: string;
+    size: number;
+    data: string;
+}
+/**
+ * In-memory implementation of GGFile.
+ * Used for tests and when file content is already fully buffered.
+ */
+export declare class BufferGGFile extends GGFile {
+    private _consumed;
+    private readonly data;
+    readonly name: string;
+    readonly mimeType: string;
+    constructor(data: Uint8Array, name: string, mimeType?: string);
+    get size(): number;
+    get consumed(): boolean;
+    protected assertNotConsumed(): void;
+    stream(): ReadableStream<Uint8Array>;
+    buffer(): Promise<Uint8Array>;
+    text(): Promise<string>;
+    clone(): GGFile;
+}
+/**
+ * Browser implementation of GGFile that wraps a native File/Blob.
+ * Lazily reads file content only when buffer()/stream()/text() is called.
+ */
+export declare class BrowserGGFile extends GGFile {
+    private readonly nativeFile;
+    private _consumed;
+    readonly name: string;
+    readonly mimeType: string;
+    readonly size: number;
+    constructor(nativeFile: File & {
+        readonly name: string;
+    });
+    get consumed(): boolean;
+    private assertNotConsumed;
+    stream(): ReadableStream<Uint8Array>;
+    buffer(): Promise<Uint8Array>;
+    text(): Promise<string>;
+    clone(): GGFile;
+}
+//# sourceMappingURL=GGFile.d.ts.map

package/dist/src/GGFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGFile.d.ts","sourceRoot":"","sources":["../../src/GGFile.ts"],"names":[],"mappings":"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"}

package/dist/src/GGFile.js

@@ -0,0 +1,187 @@
+/**
+ * Unified file abstraction for Grest framework.
+ * Works across HTTP (multipart), WebSocket (base64), and tests (in-memory).
+ *
+ * Single consumption: buffer()/stream()/text() can only be called once.
+ * Use clone() if multiple reads are needed.
+ */
+export class GGFile {
+    // ==================== Static Factory Methods ====================
+    /**
+     * Create a GGFile from a Uint8Array buffer.
+     */
+    static fromBuffer(data, name, mimeType = 'application/octet-stream') {
+        return new BufferGGFile(data, name, mimeType);
+    }
+    /**
+     * Create a GGFile from a string (encoded as UTF-8).
+     */
+    static fromString(content, name, mimeType = 'text/plain') {
+        const encoder = new TextEncoder();
+        return new BufferGGFile(encoder.encode(content), name, mimeType);
+    }
+    /**
+     * Create a GGFile from a base64-encoded string.
+     * Used for WebSocket transport where files are sent as base64.
+     */
+    static fromBase64(base64, name, mimeType = 'application/octet-stream') {
+        const binaryString = atob(base64);
+        const bytes = new Uint8Array(binaryString.length);
+        for (let i = 0; i < binaryString.length; i++) {
+            bytes[i] = binaryString.charCodeAt(i);
+        }
+        return new BufferGGFile(bytes, name, mimeType);
+    }
+    /**
+     * Convert a GGFile to base64 string.
+     * Consumes the file.
+     */
+    static async toBase64(file) {
+        const buffer = await file.buffer();
+        let binary = '';
+        for (let i = 0; i < buffer.length; i++) {
+            binary += String.fromCharCode(buffer[i]);
+        }
+        return btoa(binary);
+    }
+    /**
+     * Serialize a GGFile to JSON format for WebSocket transport.
+     * Consumes the file.
+     */
+    static async toJSON(file) {
+        return {
+            __ggfile: true,
+            name: file.name,
+            mimeType: file.mimeType,
+            size: file.size,
+            data: await GGFile.toBase64(file),
+        };
+    }
+    /**
+     * Deserialize a GGFile from JSON format.
+     */
+    static fromJSON(json) {
+        if (!json.__ggfile) {
+            throw new Error('Invalid GGFile JSON: missing __ggfile marker');
+        }
+        return GGFile.fromBase64(json.data, json.name, json.mimeType);
+    }
+    /**
+     * Check if a value is a serialized GGFile JSON.
+     */
+    static isJSON(value) {
+        return typeof value === 'object'
+            && value !== null
+            && '__ggfile' in value
+            && value.__ggfile === true
+            && 'name' in value
+            && 'mimeType' in value
+            && 'size' in value
+            && 'data' in value;
+    }
+    /**
+     * Create a GGFile from a native browser File.
+     * Lazily reads the file content only when buffer()/stream()/text() is called.
+     */
+    static fromBrowserFile(file) {
+        return new BrowserGGFile(file);
+    }
+}
+/**
+ * In-memory implementation of GGFile.
+ * Used for tests and when file content is already fully buffered.
+ */
+export class BufferGGFile extends GGFile {
+    _consumed = false;
+    data;
+    name;
+    mimeType;
+    constructor(data, name, mimeType = 'application/octet-stream') {
+        super();
+        this.data = data;
+        this.name = name;
+        this.mimeType = mimeType;
+    }
+    get size() {
+        return this.data.length;
+    }
+    get consumed() {
+        return this._consumed;
+    }
+    assertNotConsumed() {
+        if (this._consumed) {
+            throw new Error(`GGFile "${this.name}" has already been consumed. Use clone() if multiple reads are needed.`);
+        }
+    }
+    stream() {
+        this.assertNotConsumed();
+        this._consumed = true;
+        const data = this.data;
+        return new ReadableStream({
+            start(controller) {
+                controller.enqueue(data);
+                controller.close();
+            }
+        });
+    }
+    async buffer() {
+        this.assertNotConsumed();
+        this._consumed = true;
+        return this.data;
+    }
+    async text() {
+        this.assertNotConsumed();
+        this._consumed = true;
+        return new TextDecoder().decode(this.data);
+    }
+    clone() {
+        this.assertNotConsumed();
+        return new BufferGGFile(new Uint8Array(this.data), this.name, this.mimeType);
+    }
+}
+/**
+ * Browser implementation of GGFile that wraps a native File/Blob.
+ * Lazily reads file content only when buffer()/stream()/text() is called.
+ */
+export class BrowserGGFile extends GGFile {
+    nativeFile;
+    _consumed = false;
+    name;
+    mimeType;
+    size;
+    constructor(nativeFile) {
+        super();
+        this.nativeFile = nativeFile;
+        this.name = nativeFile.name;
+        this.mimeType = nativeFile.type || 'application/octet-stream';
+        this.size = nativeFile.size;
+    }
+    get consumed() {
+        return this._consumed;
+    }
+    assertNotConsumed() {
+        if (this._consumed) {
+            throw new Error(`GGFile "${this.name}" has already been consumed. Use clone() if multiple reads are needed.`);
+        }
+    }
+    stream() {
+        this.assertNotConsumed();
+        this._consumed = true;
+        return this.nativeFile.stream();
+    }
+    async buffer() {
+        this.assertNotConsumed();
+        this._consumed = true;
+        return new Uint8Array(await this.nativeFile.arrayBuffer());
+    }
+    async text() {
+        this.assertNotConsumed();
+        this._consumed = true;
+        return this.nativeFile.text();
+    }
+    clone() {
+        this.assertNotConsumed();
+        return new BrowserGGFile(this.nativeFile);
+    }
+}
+//# sourceMappingURL=GGFile.js.map

package/dist/src/GGFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGFile.js","sourceRoot":"","sources":["../../src/GGFile.ts"],"names":[],"mappings":"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"}

package/dist/src/IsFile.d.ts

@@ -0,0 +1,49 @@
+import { GGSchema, GGSchemaNonJsonDefinition, GGIssueInvalid, Opt } from "@grest-ts/schema";
+import { GGFile } from "./GGFile";
+/**
+ * Definition for file schema.
+ */
+export interface FileDef extends GGSchemaNonJsonDefinition {
+    readonly type: 'file';
+    readonly accept?: readonly string[];
+    readonly maxSize?: number;
+}
+export declare class FileSchema<T extends GGFile | undefined | null = GGFile> extends GGSchema<T, FileDef> {
+    static readonly typeError: GGIssueInvalid<{}>;
+    static readonly mimeTypeError: GGIssueInvalid<{
+        accept: string;
+    }>;
+    static readonly maxSizeError: GGIssueInvalid<{
+        max: number;
+    }>;
+    constructor(def: {
+        type: 'file';
+        accept?: readonly string[];
+        maxSize?: number;
+        optional?: boolean;
+        nullable?: boolean;
+    });
+    get orUndefined(): FileSchema<T | undefined> & Opt;
+    get orNull(): FileSchema<T | null>;
+    protected derive<NewT extends GGFile | undefined | null = T>(changes: Partial<FileDef>): FileSchema<NewT>;
+    accept(...types: string[]): FileSchema<T>;
+    maxSize(bytes: number): FileSchema<T>;
+    static image(opts?: {
+        maxSize?: number;
+    }): FileSchema;
+    static pdf(opts?: {
+        maxSize?: number;
+    }): FileSchema;
+    static any(opts?: {
+        maxSize?: number;
+    }): FileSchema;
+    static video(opts?: {
+        maxSize?: number;
+    }): FileSchema;
+    static audio(opts?: {
+        maxSize?: number;
+    }): FileSchema;
+}
+export declare const IsFile: FileSchema<GGFile>;
+export type tFile = typeof IsFile.infer;
+//# sourceMappingURL=IsFile.d.ts.map

package/dist/src/IsFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsFile.d.ts","sourceRoot":"","sources":["../../src/IsFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,yBAAyB,EAAsB,cAAc,EAAE,GAAG,EAAC,MAAM,kBAAkB,CAAC;AAE9G,OAAO,EAAe,MAAM,EAAC,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,yBAAyB;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC7B;AAiCD,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAE,SAAQ,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;IAE9F,gBAAuB,SAAS,qBAA2D;IAC3F,gBAAuB,aAAa;gBAAgC,MAAM;OAA+F;IACzK,gBAAuB,YAAY;aAA6B,MAAM;OAAuF;gBAEjJ,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAyCvH,IAAI,WAAW,IAAI,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAEjD;IAED,IAAI,MAAM,IAAI,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAEjC;IAED,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC;IAezG,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;IAKzC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAMrC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;IAKrD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;IAKnD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;IAKnD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;IAKrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;CAIxD;AAED,eAAO,MAAM,MAAM,oBAAiC,CAAC;AACrD,MAAM,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,KAAK,CAAC"}

package/dist/src/IsFile.js

@@ -0,0 +1,125 @@
+import { GGSchema, GGIssueInvalid } from "@grest-ts/schema";
+import { BufferGGFile } from "./GGFile.js";
+// ==================== Helper Functions ====================
+function isGGFileLike(value) {
+    return typeof value === 'object'
+        && value !== null
+        && 'name' in value
+        && 'mimeType' in value
+        && 'size' in value
+        && typeof value.name === 'string'
+        && typeof value.mimeType === 'string'
+        && typeof value.size === 'number';
+}
+function matchesAccept(name, mimeType, accept) {
+    if (!accept || accept.length === 0)
+        return true;
+    for (const pattern of accept) {
+        if (pattern.startsWith('.')) {
+            if (name.toLowerCase().endsWith(pattern.toLowerCase()))
+                return true;
+        }
+        else if (pattern === '*/*') {
+            return true;
+        }
+        else if (pattern.endsWith('/*')) {
+            if (mimeType.startsWith(pattern.slice(0, -1)))
+                return true;
+        }
+        else {
+            if (mimeType === pattern)
+                return true;
+        }
+    }
+    return false;
+}
+// ==================== FileSchema ====================
+export class FileSchema extends GGSchema {
+    static typeError = new GGIssueInvalid("file.type", "Value must be a file");
+    static mimeTypeError = new GGIssueInvalid("file.mimeType", "File type not accepted, expected: {accept}", { accept: "Accepted types" });
+    static maxSizeError = new GGIssueInvalid("file.maxSize", "File exceeds maximum size of {max} bytes", { max: "Maximum size" });
+    constructor(def) {
+        const { accept, maxSize } = def;
+        const is = (value) => {
+            if (!isGGFileLike(value))
+                return false;
+            return matchesAccept(value.name, value.mimeType, accept) && (maxSize === undefined || value.size <= maxSize);
+        };
+        const isWithErrors = (value, issues, path) => {
+            if (!isGGFileLike(value)) {
+                return FileSchema.typeError.add(value, issues, path);
+            }
+            let valid = true;
+            if (!matchesAccept(value.name, value.mimeType, accept)) {
+                FileSchema.mimeTypeError.add(value, issues, path, { accept: accept?.join(', ') ?? '*/*' });
+                valid = false;
+            }
+            if (maxSize !== undefined && value.size > maxSize) {
+                FileSchema.maxSizeError.add(value, issues, path, { max: maxSize });
+                valid = false;
+            }
+            return valid;
+        };
+        const encodeToRaw = async (value, path) => {
+            const file = value;
+            const buffer = await file.clone().buffer();
+            const blob = new Blob([buffer], { type: file.mimeType });
+            return { path, blob, filename: file.name };
+        };
+        const decodeFromRaw = async (raw) => {
+            const buffer = await raw.blob.arrayBuffer();
+            return new BufferGGFile(new Uint8Array(buffer), raw.filename || 'file', raw.blob.type);
+        };
+        super({ ...def, hasNonJsonData: true, is, isWithErrors, encodeToRaw, decodeFromRaw });
+    }
+    // ==================== Schema Methods ====================
+    get orUndefined() {
+        return super.orUndefined;
+    }
+    get orNull() {
+        return super.orNull;
+    }
+    derive(changes) {
+        if (this.def.maxSize !== undefined && changes.maxSize !== undefined && changes.maxSize > this.def.maxSize) {
+            throw new Error(`Cannot raise maxSize from ${this.def.maxSize} to ${changes.maxSize}`);
+        }
+        return new FileSchema({
+            type: 'file',
+            accept: changes.accept ?? this.def.accept,
+            maxSize: changes.maxSize ?? this.def.maxSize,
+            optional: changes.optional ?? this.def.optional,
+            nullable: changes.nullable ?? this.def.nullable
+        });
+    }
+    // ==================== File Constraints ====================
+    accept(...types) {
+        const combined = this.def.accept ? [...this.def.accept, ...types] : types;
+        return this.derive({ accept: combined });
+    }
+    maxSize(bytes) {
+        return this.derive({ maxSize: bytes });
+    }
+    // ==================== Static Shortcuts ====================
+    static image(opts) {
+        let s = new FileSchema({ type: 'file', accept: ['image/*'] });
+        return opts?.maxSize ? s.maxSize(opts.maxSize) : s;
+    }
+    static pdf(opts) {
+        let s = new FileSchema({ type: 'file', accept: ['application/pdf'] });
+        return opts?.maxSize ? s.maxSize(opts.maxSize) : s;
+    }
+    static any(opts) {
+        let s = new FileSchema({ type: 'file' });
+        return opts?.maxSize ? s.maxSize(opts.maxSize) : s;
+    }
+    static video(opts) {
+        let s = new FileSchema({ type: 'file', accept: ['video/*'] });
+        return opts?.maxSize ? s.maxSize(opts.maxSize) : s;
+    }
+    static audio(opts) {
+        let s = new FileSchema({ type: 'file', accept: ['audio/*'] });
+        return opts?.maxSize ? s.maxSize(opts.maxSize) : s;
+    }
+}
+export const IsFile = new FileSchema({ type: 'file' });
+//# sourceMappingURL=IsFile.js.map

package/dist/src/IsFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsFile.js","sourceRoot":"","sources":["../../src/IsFile.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./GGFile";
+export * from "./IsFile";
+export { BufferGGFile, BrowserGGFile } from "./GGFile";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AAEzB,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,UAAU,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export * from "./GGFile.js";
+export * from "./IsFile.js";
+export { BufferGGFile, BrowserGGFile } from "./GGFile.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AAEzB,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,UAAU,CAAC"}

package/dist/src/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "//": "THIS FILE IS GENERATED - DO NOT EDIT",
+  "extends": "../../../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "**/*"
+  ]
+}

package/dist/testkit/GGTestFile.d.ts

@@ -0,0 +1,63 @@
+import { GGFile } from "@grest-ts/file";
+/**
+ * Test utilities for creating GGFile instances in tests.
+ *
+ * @example
+ * ```typescript
+ * // Create from buffer
+ * const file = GGTestFile.fromBuffer(
+ *   new Uint8Array([0x89, 0x50, 0x4E, 0x47]),
+ *   'test.png',
+ *   'image/png'
+ * );
+ *
+ * // Create from string
+ * const textFile = GGTestFile.fromString('Hello World', 'hello.txt');
+ *
+ * // Generate random test files
+ * const randomImage = GGTestFile.random(1024, 'test.png', 'image/png');
+ * ```
+ */
+export declare const GGTestFile: {
+    /**
+     * Create a GGFile from a Uint8Array buffer.
+     */
+    fromBuffer(data: Uint8Array, name: string, mimeType?: string): GGFile;
+    /**
+     * Create a GGFile from a string (encoded as UTF-8).
+     */
+    fromString(content: string, name: string, mimeType?: string): GGFile;
+    /**
+     * Create a GGFile from a base64-encoded string.
+     */
+    fromBase64(base64: string, name: string, mimeType?: string): GGFile;
+    /**
+     * Create a GGFile with random bytes of specified size.
+     * Useful for testing file size limits.
+     */
+    random(size: number, name: string, mimeType?: string): GGFile;
+    /**
+     * Create a minimal valid PNG file (1x1 transparent pixel).
+     * Useful for testing image upload endpoints.
+     */
+    png1x1(name?: string): GGFile;
+    /**
+     * Create a minimal valid JPEG file (1x1 red pixel).
+     * Useful for testing image upload endpoints.
+     */
+    jpeg1x1(name?: string): GGFile;
+    /**
+     * Create a minimal valid PDF file.
+     * Useful for testing document upload endpoints.
+     */
+    pdf(name?: string): GGFile;
+    /**
+     * Create a JSON file from an object.
+     */
+    json(data: unknown, name?: string): GGFile;
+    /**
+     * Create a CSV file from rows.
+     */
+    csv(rows: string[][], name?: string): GGFile;
+};
+//# sourceMappingURL=GGTestFile.d.ts.map

package/dist/testkit/GGTestFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGTestFile.d.ts","sourceRoot":"","sources":["../../testkit/GGTestFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,gBAAgB,CAAC;AAEtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU;IACnB;;OAEG;qBACc,UAAU,QAAQ,MAAM,aAAY,MAAM,GAAgC,MAAM;IAIjG;;OAEG;wBACiB,MAAM,QAAQ,MAAM,aAAY,MAAM,GAAkB,MAAM;IAIlF;;OAEG;uBACgB,MAAM,QAAQ,MAAM,aAAY,MAAM,GAAgC,MAAM;IAI/F;;;OAGG;iBACU,MAAM,QAAQ,MAAM,aAAY,MAAM,GAAgC,MAAM;IASzF;;;OAGG;kBACU,MAAM,GAAgB,MAAM;IAgBzC;;;OAGG;mBACW,MAAM,GAAgB,MAAM;IAoC1C;;;OAGG;eACO,MAAM,GAAgB,MAAM;IA0BtC;;OAEG;eACQ,OAAO,SAAQ,MAAM,GAAiB,MAAM;IAKvD;;OAEG;cACO,MAAM,EAAE,EAAE,SAAQ,MAAM,GAAgB,MAAM;CAU3D,CAAC"}