@vankyle/storage-shared 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# @vankyle-hub/storage-shared
+
+Cross-package utilities, error types, and foundational TypeScript types for `vankyle-storage`.
+
+This package has no internal dependencies and must not import from any other package in this monorepo.
+
+## Contents
+
+### Error types
+
+All errors extend `BaseError`, which extends the native `Error` class and adds a `code: string` field and an optional `cause`.
+
+| Class | Code | Extra fields |
+|---|---|---|
+| `BaseError` | (abstract) | `code`, `cause?` |
+| `StorageError` | `STORAGE_ERROR` | — |
+| `StorageObjectNotFoundError` | `STORAGE_OBJECT_NOT_FOUND` | `bucket`, `objectKey` |
+| `CapabilityNotSupportedError` | `CAPABILITY_NOT_SUPPORTED` | `capability` |
+| `MetadataError` | `METADATA_ERROR` | — |
+| `MetadataNotFoundError` | `METADATA_NOT_FOUND` | `entityType`, `entityId` |
+| `MetadataConflictError` | `METADATA_CONFLICT` | `entityType`, `entityId` |
+| `ValidationError` | `VALIDATION_ERROR` | `field?` |
+
+### `Result<T, E>`
+
+A lightweight railway-oriented result type. No dependency on external libraries.
+
+```typescript
+import { ok, err, type Result } from "@vankyle-hub/storage-shared";
+
+function divide(a: number, b: number): Result<number, Error> {
+  if (b === 0) return err(new Error("division by zero"));
+  return ok(a / b);
+}
+
+const result = divide(10, 2);
+if (result.ok) {
+  console.log(result.value); // 5
+} else {
+  console.error(result.error);
+}
+```
+
+### TypeScript utility types
+
+| Type | Description |
+|---|---|
+| `JsonValue` | `string \| number \| boolean \| null \| JsonObject \| JsonArray` |
+| `JsonObject` | `{ [key: string]: JsonValue }` |
+| `JsonArray` | `JsonValue[]` |
+| `Maybe<T>` | `T \| undefined` |
+| `PartialBy<T, K>` | Make keys `K` optional in `T` |
+| `RequiredBy<T, K>` | Make keys `K` required in `T` |
+| `Defined<T>` | Remove `undefined` from `T` |
+
+### Utilities
+
+```typescript
+import { assert, assertNever } from "@vankyle-hub/storage-shared";
+import { getRequiredEnv, getOptionalEnv } from "@vankyle-hub/storage-shared";
+
+// Assertion (throws with message if falsy)
+assert(user !== null, "user must exist");
+
+// Exhaustive switch guard
+switch (status) {
+  case "active": ...
+  case "deleted": ...
+  default: assertNever(status); // compile error if a case is missing
+}
+
+// Environment variable helpers
+const region = getRequiredEnv("AWS_REGION");          // throws if missing
+const prefix = getOptionalEnv("KEY_PREFIX", "uploads"); // returns fallback if missing
+```

package/dist/errors/base-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Base error class for the storage system.
+ * All domain-specific errors should extend this.
+ */
+export declare class BaseError extends Error {
+    readonly code: string;
+    readonly cause?: unknown;
+    constructor(code: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=base-error.d.ts.map

package/dist/errors/base-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-error.d.ts","sourceRoot":"","sources":["../../src/errors/base-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAMzE"}

package/dist/errors/base-error.js

@@ -0,0 +1,15 @@
+/**
+ * Base error class for the storage system.
+ * All domain-specific errors should extend this.
+ */
+export class BaseError extends Error {
+    code;
+    cause;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.cause = options?.cause;
+    }
+}
+//# sourceMappingURL=base-error.js.map

package/dist/errors/base-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-error.js","sourceRoot":"","sources":["../../src/errors/base-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAS;IACb,KAAK,CAAW;IAEzB,YAAY,IAAY,EAAE,OAAe,EAAE,OAA6B;QACtE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAC9B,CAAC;CACF"}

package/dist/errors/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/errors/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/errors/errors.test.ts"],"names":[],"mappings":""}

package/dist/errors/errors.test.js

@@ -0,0 +1,80 @@
+import { describe, it, expect } from "vitest";
+import { BaseError, StorageError, StorageObjectNotFoundError, CapabilityNotSupportedError, MetadataError, MetadataNotFoundError, MetadataConflictError, ValidationError, } from "@vankyle-hub/storage-shared";
+describe("BaseError", () => {
+    it("should set code and message", () => {
+        const err = new BaseError("TEST_CODE", "test message");
+        expect(err.code).toBe("TEST_CODE");
+        expect(err.message).toBe("test message");
+        expect(err.name).toBe("BaseError");
+        expect(err).toBeInstanceOf(Error);
+    });
+    it("should capture cause", () => {
+        const cause = new Error("root");
+        const err = new BaseError("TEST", "wrapped", { cause });
+        expect(err.cause).toBe(cause);
+    });
+});
+describe("StorageError", () => {
+    it("should use STORAGE_ERROR code", () => {
+        const err = new StorageError("something broke");
+        expect(err.code).toBe("STORAGE_ERROR");
+        expect(err.message).toBe("something broke");
+        expect(err).toBeInstanceOf(BaseError);
+    });
+});
+describe("StorageObjectNotFoundError", () => {
+    it("should include bucket and objectKey", () => {
+        const err = new StorageObjectNotFoundError("my-bucket", "path/to/file.txt");
+        expect(err.code).toBe("STORAGE_OBJECT_NOT_FOUND");
+        expect(err.bucket).toBe("my-bucket");
+        expect(err.objectKey).toBe("path/to/file.txt");
+        expect(err.message).toContain("my-bucket");
+        expect(err.message).toContain("path/to/file.txt");
+    });
+});
+describe("CapabilityNotSupportedError", () => {
+    it("should include capability name", () => {
+        const err = new CapabilityNotSupportedError("signedPartUrl");
+        expect(err.code).toBe("CAPABILITY_NOT_SUPPORTED");
+        expect(err.capability).toBe("signedPartUrl");
+        expect(err.message).toContain("signedPartUrl");
+    });
+});
+describe("MetadataError", () => {
+    it("should use METADATA_ERROR code", () => {
+        const err = new MetadataError("db failure");
+        expect(err.code).toBe("METADATA_ERROR");
+        expect(err.message).toBe("db failure");
+    });
+});
+describe("MetadataNotFoundError", () => {
+    it("should include entityType and entityId", () => {
+        const err = new MetadataNotFoundError("Blob", "abc-123");
+        expect(err.code).toBe("METADATA_NOT_FOUND");
+        expect(err.entityType).toBe("Blob");
+        expect(err.entityId).toBe("abc-123");
+        expect(err.message).toContain("Blob");
+        expect(err.message).toContain("abc-123");
+    });
+});
+describe("MetadataConflictError", () => {
+    it("should include entityType and entityId", () => {
+        const err = new MetadataConflictError("File", "xyz");
+        expect(err.code).toBe("METADATA_CONFLICT");
+        expect(err.entityType).toBe("File");
+        expect(err.entityId).toBe("xyz");
+    });
+});
+describe("ValidationError", () => {
+    it("should include field when provided", () => {
+        const err = new ValidationError("invalid value", "email");
+        expect(err.code).toBe("VALIDATION_ERROR");
+        expect(err.field).toBe("email");
+        expect(err.message).toBe("invalid value");
+    });
+    it("should work without field", () => {
+        const err = new ValidationError("bad input");
+        expect(err.field).toBeUndefined();
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/errors/errors.test.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,5 @@
+export { BaseError } from "./base-error.js";
+export { StorageError, StorageObjectNotFoundError, CapabilityNotSupportedError, } from "./storage-error.js";
+export { MetadataError, MetadataNotFoundError, MetadataConflictError, } from "./metadata-error.js";
+export { ValidationError } from "./validation-error.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,5 @@
+export { BaseError } from "./base-error.js";
+export { StorageError, StorageObjectNotFoundError, CapabilityNotSupportedError, } from "./storage-error.js";
+export { MetadataError, MetadataNotFoundError, MetadataConflictError, } from "./metadata-error.js";
+export { ValidationError } from "./validation-error.js";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/errors/metadata-error.d.ts

@@ -0,0 +1,21 @@
+import { BaseError } from "./base-error.js";
+export declare class MetadataError extends BaseError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class MetadataNotFoundError extends BaseError {
+    readonly entityType: string;
+    readonly entityId: string;
+    constructor(entityType: string, entityId: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class MetadataConflictError extends BaseError {
+    readonly entityType: string;
+    readonly entityId: string;
+    constructor(entityType: string, entityId: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=metadata-error.d.ts.map

package/dist/errors/metadata-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-error.d.ts","sourceRoot":"","sources":["../../src/errors/metadata-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG3D;AAED,qBAAa,qBAAsB,SAAQ,SAAS;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKhF;AAED,qBAAa,qBAAsB,SAAQ,SAAS;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKhF"}

package/dist/errors/metadata-error.js

@@ -0,0 +1,25 @@
+import { BaseError } from "./base-error.js";
+export class MetadataError extends BaseError {
+    constructor(message, options) {
+        super("METADATA_ERROR", message, options);
+    }
+}
+export class MetadataNotFoundError extends BaseError {
+    entityType;
+    entityId;
+    constructor(entityType, entityId, options) {
+        super("METADATA_NOT_FOUND", `${entityType} not found: ${entityId}`, options);
+        this.entityType = entityType;
+        this.entityId = entityId;
+    }
+}
+export class MetadataConflictError extends BaseError {
+    entityType;
+    entityId;
+    constructor(entityType, entityId, options) {
+        super("METADATA_CONFLICT", `${entityType} conflict: ${entityId}`, options);
+        this.entityType = entityType;
+        this.entityId = entityId;
+    }
+}
+//# sourceMappingURL=metadata-error.js.map

package/dist/errors/metadata-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-error.js","sourceRoot":"","sources":["../../src/errors/metadata-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IACzC,UAAU,CAAS;IACnB,QAAQ,CAAS;IAE1B,YAAY,UAAkB,EAAE,QAAgB,EAAE,OAA6B;QAC7E,KAAK,CAAC,oBAAoB,EAAE,GAAG,UAAU,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IACzC,UAAU,CAAS;IACnB,QAAQ,CAAS;IAE1B,YAAY,UAAkB,EAAE,QAAgB,EAAE,OAA6B;QAC7E,KAAK,CAAC,mBAAmB,EAAE,GAAG,UAAU,cAAc,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/errors/storage-error.d.ts

@@ -0,0 +1,20 @@
+import { BaseError } from "./base-error.js";
+export declare class StorageError extends BaseError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class StorageObjectNotFoundError extends BaseError {
+    readonly bucket: string;
+    readonly objectKey: string;
+    constructor(bucket: string, objectKey: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class CapabilityNotSupportedError extends BaseError {
+    readonly capability: string;
+    constructor(capability: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=storage-error.d.ts.map

package/dist/errors/storage-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-error.d.ts","sourceRoot":"","sources":["../../src/errors/storage-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG3D;AAED,qBAAa,0BAA2B,SAAQ,SAAS;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK7E;AAED,qBAAa,2BAA4B,SAAQ,SAAS;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI9D"}

package/dist/errors/storage-error.js

@@ -0,0 +1,23 @@
+import { BaseError } from "./base-error.js";
+export class StorageError extends BaseError {
+    constructor(message, options) {
+        super("STORAGE_ERROR", message, options);
+    }
+}
+export class StorageObjectNotFoundError extends BaseError {
+    bucket;
+    objectKey;
+    constructor(bucket, objectKey, options) {
+        super("STORAGE_OBJECT_NOT_FOUND", `Object not found: ${bucket}/${objectKey}`, options);
+        this.bucket = bucket;
+        this.objectKey = objectKey;
+    }
+}
+export class CapabilityNotSupportedError extends BaseError {
+    capability;
+    constructor(capability, options) {
+        super("CAPABILITY_NOT_SUPPORTED", `Capability not supported: ${capability}`, options);
+        this.capability = capability;
+    }
+}
+//# sourceMappingURL=storage-error.js.map

package/dist/errors/storage-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-error.js","sourceRoot":"","sources":["../../src/errors/storage-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,SAAS;IAC9C,MAAM,CAAS;IACf,SAAS,CAAS;IAE3B,YAAY,MAAc,EAAE,SAAiB,EAAE,OAA6B;QAC1E,KAAK,CAAC,0BAA0B,EAAE,qBAAqB,MAAM,IAAI,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;QACvF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,SAAS;IAC/C,UAAU,CAAS;IAE5B,YAAY,UAAkB,EAAE,OAA6B;QAC3D,KAAK,CAAC,0BAA0B,EAAE,6BAA6B,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;QACtF,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/errors/validation-error.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from "./base-error.js";
+export declare class ValidationError extends BaseError {
+    readonly field?: string | undefined;
+    constructor(message: string, field?: string | undefined, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/errors/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../src/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIvF"}

package/dist/errors/validation-error.js

@@ -0,0 +1,9 @@
+import { BaseError } from "./base-error.js";
+export class ValidationError extends BaseError {
+    field;
+    constructor(message, field, options) {
+        super("VALIDATION_ERROR", message, options);
+        this.field = field;
+    }
+}
+//# sourceMappingURL=validation-error.js.map

package/dist/errors/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../../src/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IACnC,KAAK,CAAsB;IAEpC,YAAY,OAAe,EAAE,KAA0B,EAAE,OAA6B;QACpF,KAAK,CAAC,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./errors/index.js";
+export * from "./types/index.js";
+export * from "./utils/index.js";
+//# 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,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./errors/index.js";
+export * from "./types/index.js";
+export * from "./utils/index.js";
+//# 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,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export type { JsonPrimitive, JsonArray, JsonObject, JsonValue, PartialBy, RequiredBy, Defined, Maybe } from "./json.js";
+export { type Result, ok, err } from "./result.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACxH,OAAO,EAAE,KAAK,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export { ok, err } from "./result.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/json.d.ts

@@ -0,0 +1,19 @@
+/** JSON-compatible primitive types */
+export type JsonPrimitive = string | number | boolean | null;
+/** JSON-compatible array */
+export type JsonArray = JsonValue[];
+/** JSON-compatible object */
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+/** Any JSON-compatible value */
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+/** Make selected properties optional */
+export type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/** Make selected properties required */
+export type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/** Extract non-undefined type */
+export type Defined<T> = T extends undefined ? never : T;
+/** A value that may or may not be present */
+export type Maybe<T> = T | undefined;
+//# sourceMappingURL=json.d.ts.map

package/dist/types/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/types/json.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D,4BAA4B;AAC5B,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AAEpC,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,gCAAgC;AAChC,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D,wCAAwC;AACxC,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/E,wCAAwC;AACxC,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEjF,iCAAiC;AACjC,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;AAEzD,6CAA6C;AAC7C,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC"}

package/dist/types/json.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json.js.map

package/dist/types/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/types/json.ts"],"names":[],"mappings":""}

package/dist/types/result.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Represents an operation result that can either succeed or fail.
+ */
+export type Result<T, E = Error> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+export declare function ok<T>(value: T): Result<T, never>;
+export declare function err<E>(error: E): Result<never, E>;
+//# sourceMappingURL=result.d.ts.map

package/dist/types/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE9C,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD"}

package/dist/types/result.js

@@ -0,0 +1,7 @@
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=result.js.map

package/dist/types/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/types/result.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC"}

package/dist/types/result.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result.test.d.ts.map

package/dist/types/result.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.test.d.ts","sourceRoot":"","sources":["../../src/types/result.test.ts"],"names":[],"mappings":""}

package/dist/types/result.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect } from "vitest";
+import { ok, err } from "@vankyle-hub/storage-shared";
+describe("Result type", () => {
+    it("ok() should create a success result", () => {
+        const result = ok(42);
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.value).toBe(42);
+        }
+    });
+    it("err() should create a failure result", () => {
+        const result = err("something went wrong");
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error).toBe("something went wrong");
+        }
+    });
+    it("should work with complex types", () => {
+        const success = ok({ id: "abc" });
+        expect(success.ok).toBe(true);
+        if (success.ok) {
+            expect(success.value.id).toBe("abc");
+        }
+        const failure = err(new Error("fail"));
+        expect(failure.ok).toBe(false);
+        if (!failure.ok) {
+            expect(failure.error.message).toBe("fail");
+        }
+    });
+});
+//# sourceMappingURL=result.test.js.map

package/dist/types/result.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.test.js","sourceRoot":"","sources":["../../src/types/result.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAGtD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACtB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,OAAO,GAAkC,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,OAAO,GAAkC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/assert.d.ts

@@ -0,0 +1,3 @@
+export declare function assert(condition: unknown, message?: string): asserts condition;
+export declare function assertNever(value: never, message?: string): never;
+//# sourceMappingURL=assert.d.ts.map

package/dist/utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAI9E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAEjE"}

package/dist/utils/assert.js

@@ -0,0 +1,9 @@
+export function assert(condition, message) {
+    if (!condition) {
+        throw new Error(message ?? "Assertion failed");
+    }
+}
+export function assertNever(value, message) {
+    throw new Error(message ?? `Unexpected value: ${String(value)}`);
+}
+//# sourceMappingURL=assert.js.map

package/dist/utils/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,OAAgB;IACzD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,kBAAkB,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,OAAgB;IACxD,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,qBAAqB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/utils/env.d.ts

@@ -0,0 +1,3 @@
+export declare function getRequiredEnv(key: string): string;
+export declare function getOptionalEnv(key: string, fallback?: string): string | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjF"}

package/dist/utils/env.js

@@ -0,0 +1,11 @@
+export function getRequiredEnv(key) {
+    const value = process.env[key];
+    if (value === undefined || value === "") {
+        throw new Error(`Required environment variable "${key}" is not set`);
+    }
+    return value;
+}
+export function getOptionalEnv(key, fallback) {
+    return process.env[key] ?? fallback;
+}
+//# sourceMappingURL=env.js.map

package/dist/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,cAAc,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,QAAiB;IAC3D,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;AACtC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { assert, assertNever } from "./assert.js";
+export { getRequiredEnv, getOptionalEnv } from "./env.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export { assert, assertNever } from "./assert.js";
+export { getRequiredEnv, getOptionalEnv } from "./env.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/utils/utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.test.d.ts.map

package/dist/utils/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../src/utils/utils.test.ts"],"names":[],"mappings":""}

package/dist/utils/utils.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { assert, assertNever, getRequiredEnv, getOptionalEnv } from "@vankyle-hub/storage-shared";
+describe("assert", () => {
+    it("should not throw when condition is truthy", () => {
+        expect(() => assert(true)).not.toThrow();
+        expect(() => assert(1)).not.toThrow();
+        expect(() => assert("non-empty")).not.toThrow();
+    });
+    it("should throw when condition is falsy", () => {
+        expect(() => assert(false)).toThrow("Assertion failed");
+        expect(() => assert(null)).toThrow();
+        expect(() => assert(0)).toThrow();
+        expect(() => assert("")).toThrow();
+    });
+    it("should use custom message", () => {
+        expect(() => assert(false, "custom message")).toThrow("custom message");
+    });
+});
+describe("assertNever", () => {
+    it("should throw with value description", () => {
+        expect(() => assertNever("oops")).toThrow("Unexpected value: oops");
+    });
+    it("should use custom message", () => {
+        expect(() => assertNever("x", "custom")).toThrow("custom");
+    });
+});
+describe("getRequiredEnv", () => {
+    afterEach(() => {
+        delete process.env["TEST_REQUIRED_VAR"];
+    });
+    it("should return env value when set", () => {
+        process.env["TEST_REQUIRED_VAR"] = "hello";
+        expect(getRequiredEnv("TEST_REQUIRED_VAR")).toBe("hello");
+    });
+    it("should throw when env is not set", () => {
+        expect(() => getRequiredEnv("TEST_REQUIRED_VAR")).toThrow();
+    });
+    it("should throw when env is empty string", () => {
+        process.env["TEST_REQUIRED_VAR"] = "";
+        expect(() => getRequiredEnv("TEST_REQUIRED_VAR")).toThrow();
+    });
+});
+describe("getOptionalEnv", () => {
+    afterEach(() => {
+        delete process.env["TEST_OPT_VAR"];
+    });
+    it("should return env value when set", () => {
+        process.env["TEST_OPT_VAR"] = "world";
+        expect(getOptionalEnv("TEST_OPT_VAR")).toBe("world");
+    });
+    it("should return undefined when not set and no fallback", () => {
+        expect(getOptionalEnv("TEST_OPT_VAR")).toBeUndefined();
+    });
+    it("should return fallback when not set", () => {
+        expect(getOptionalEnv("TEST_OPT_VAR", "default")).toBe("default");
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/utils/utils.test.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@vankyle/storage-shared",
+  "version": "0.1.0",
+  "description": "Shared errors, utility types, and helpers for vankyle-storage.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b tsconfig.json --force",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vankyle-Hub/storage-ts.git",
+    "directory": "packages/shared"
+  },
+  "bugs": {
+    "url": "https://github.com/Vankyle-Hub/storage-ts/issues"
+  },
+  "homepage": "https://github.com/Vankyle-Hub/storage-ts",
+  "packageManager": "pnpm@10.28.2",
+  "publishConfig": {
+    "access": "public"
+  }
+}