@fengsoft/storage-core 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+export type StorageMetadata = Record<string, string>;
+export type StorageBody = Buffer | Uint8Array | string;
+export type PutObjectInput = {
+    key: string;
+    body: StorageBody;
+    contentType?: string;
+    cacheControl?: string;
+    metadata?: StorageMetadata;
+};
+export type DeleteObjectInput = {
+    key: string;
+};
+export type HeadObjectResult = {
+    key: string;
+    contentLength: number | null;
+    contentType: string | null;
+    cacheControl: string | null;
+    etag: string | null;
+    lastModified: Date | null;
+    metadata: StorageMetadata;
+};
+export type GetObjectResult = HeadObjectResult & {
+    body: Buffer;
+};
+export type ListedObject = {
+    key: string;
+    contentLength: number;
+    lastModified: Date | null;
+    etag: string | null;
+};
+export type ListObjectsInput = {
+    prefix?: string;
+    cursor?: string | null;
+    limit?: number;
+};
+export type ListObjectsResult = {
+    items: ListedObject[];
+    nextCursor: string | null;
+};
+export type CreatePresignedUploadInput = {
+    key: string;
+    contentType?: string;
+    cacheControl?: string;
+    metadata?: StorageMetadata;
+    expiresInSeconds?: number;
+};
+export type PresignedUpload = {
+    key: string;
+    method: "PUT";
+    url: string;
+    headers: Record<string, string>;
+    expiresAt: Date;
+};
+export interface StorageDriver {
+    putObject(input: PutObjectInput): Promise<HeadObjectResult>;
+    deleteObject(input: DeleteObjectInput): Promise<void>;
+    headObject(input: DeleteObjectInput): Promise<HeadObjectResult>;
+    getObject(input: DeleteObjectInput): Promise<GetObjectResult>;
+    listObjects(input?: ListObjectsInput): Promise<ListObjectsResult>;
+    createPresignedUpload(input: CreatePresignedUploadInput): Promise<PresignedUpload>;
+    resolvePublicUrl(key: string): string | null;
+}
+export declare class StorageObjectNotFoundError extends Error {
+    readonly key: string;
+    constructor(key: string);
+}
+export declare function toBuffer(body: StorageBody): Buffer;
+export declare function encodeStorageKey(key: string): string;
+export declare function buildPublicUrl(publicBaseUrl: string | null | undefined, key: string): string | null;
+export declare function decodeCursor(cursor: string | null | undefined): number;
+export declare function toCursor(index: number, total: number): string | null;
+//# 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,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAChD,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9D,WAAW,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClE,qBAAqB,CACpB,KAAK,EAAE,0BAA0B,GAC/B,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;CAKvB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAQlD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,wBAAgB,cAAc,CAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,GAAG,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAQf;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAMtE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE"}

package/dist/index.js

@@ -0,0 +1,43 @@
+export class StorageObjectNotFoundError extends Error {
+    key;
+    constructor(key) {
+        super(`Storage object not found: ${key}`);
+        this.name = "StorageObjectNotFoundError";
+        this.key = key;
+    }
+}
+export function toBuffer(body) {
+    if (Buffer.isBuffer(body)) {
+        return body;
+    }
+    if (body instanceof Uint8Array) {
+        return Buffer.from(body);
+    }
+    return Buffer.from(body);
+}
+export function encodeStorageKey(key) {
+    return key
+        .split("/")
+        .map((segment) => encodeURIComponent(segment))
+        .join("/");
+}
+export function buildPublicUrl(publicBaseUrl, key) {
+    if (!publicBaseUrl) {
+        return null;
+    }
+    const normalizedBase = publicBaseUrl.endsWith("/")
+        ? publicBaseUrl.slice(0, -1)
+        : publicBaseUrl;
+    return `${normalizedBase}/${encodeStorageKey(key)}`;
+}
+export function decodeCursor(cursor) {
+    if (!cursor) {
+        return 0;
+    }
+    const parsed = Number.parseInt(cursor, 10);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;
+}
+export function toCursor(index, total) {
+    return index < total ? String(index) : null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4EA,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC3C,GAAG,CAAS;IAErB,YAAY,GAAW;QACtB,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IAChB,CAAC;CACD;AAED,MAAM,UAAU,QAAQ,CAAC,IAAiB;IACzC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC3C,OAAO,GAAG;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;SAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAC7B,aAAwC,EACxC,GAAW;IAEX,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC;QACjD,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC,CAAC,aAAa,CAAC;IACjB,OAAO,GAAG,cAAc,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAiC;IAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACV,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAa;IACpD,OAAO,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fengsoft/storage-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",