@varity-labs/types 2.0.0-alpha.1

package/dist/common.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Common TypeScript Types for Varity SDK
+ *
+ * Provides type-safe alternatives to `any` for common patterns.
+ * Use these types to improve type safety across the codebase.
+ */
+/**
+ * JSON-serializable value
+ * Use this instead of `any` for data that will be JSON serialized/deserialized
+ */
+export type JSONValue = string | number | boolean | null | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+/**
+ * JSON object (key-value pairs)
+ * Use this for objects with unknown keys but JSON-serializable values
+ */
+export type JSONObject = {
+    [key: string]: JSONValue;
+};
+/**
+ * JSON array
+ * Use this for arrays with unknown structure but JSON-serializable values
+ */
+export type JSONArray = JSONValue[];
+/**
+ * Record with string keys and unknown values
+ * Use this for objects when you truly don't know the value types
+ * but know keys are strings
+ */
+export type StringRecord = Record<string, unknown>;
+/**
+ * Metadata object (commonly used across Varity types)
+ * String keys with any JSON-serializable value
+ */
+export type Metadata = Record<string, JSONValue>;
+/**
+ * Error with message property (for catch blocks)
+ * Use this to safely type errors in catch blocks
+ */
+export interface ErrorWithMessage {
+    message: string;
+}
+/**
+ * Type guard to check if error has a message
+ */
+export declare function isErrorWithMessage(error: unknown): error is ErrorWithMessage;
+/**
+ * Convert unknown error to Error instance
+ * Use this in catch blocks to safely get an Error object
+ */
+export declare function toError(error: unknown): Error;
+/**
+ * Get error message from unknown error
+ * Use this in catch blocks when you just need the message
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Callback function type with unknown parameters
+ * Use this instead of (...args: any[]) => any
+ */
+export type Callback<T = void> = (...args: unknown[]) => T;
+/**
+ * Async callback function type
+ */
+export type AsyncCallback<T = void> = (...args: unknown[]) => Promise<T>;
+/**
+ * Event handler type for React and DOM events
+ * Use this for generic event handlers
+ */
+export type EventHandler<E = Event> = (event: E) => void;
+/**
+ * Async event handler type
+ */
+export type AsyncEventHandler<E = Event> = (event: E) => Promise<void>;
+/**
+ * Constructor type for classes
+ * Use this when you need to pass a class constructor
+ */
+export type Constructor<T = unknown> = new (...args: unknown[]) => T;
+/**
+ * Abstract constructor type
+ */
+export type AbstractConstructor<T = unknown> = abstract new (...args: unknown[]) => T;
+/**
+ * Function type with unknown parameters and return type
+ * Use this for truly generic functions
+ */
+export type AnyFunction = (...args: unknown[]) => unknown;
+/**
+ * Promise or value (for functions that can be sync or async)
+ */
+export type MaybePromise<T> = T | Promise<T>;
+/**
+ * Nullable type (value or null)
+ */
+export type Nullable<T> = T | null;
+/**
+ * Optional type (value or undefined)
+ */
+export type Optional<T> = T | undefined;
+/**
+ * Maybe type (value, null, or undefined)
+ */
+export type Maybe<T> = T | null | undefined;
+/**
+ * Deep partial - makes all properties optional recursively
+ */
+export type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+/**
+ * Deep readonly - makes all properties readonly recursively
+ */
+export type DeepReadonly<T> = T extends object ? {
+    readonly [P in keyof T]: DeepReadonly<T[P]>;
+} : T;
+/**
+ * Require at least one property from a type
+ */
+export type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
+    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
+}[Keys];
+/**
+ * Require exactly one property from a type
+ */
+export type RequireExactlyOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
+    [K in Keys]-?: Required<Pick<T, K>> & Partial<Record<Exclude<Keys, K>, undefined>>;
+}[Keys];
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

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

package/dist/common.js

@@ -0,0 +1,47 @@
+/**
+ * Common TypeScript Types for Varity SDK
+ *
+ * Provides type-safe alternatives to `any` for common patterns.
+ * Use these types to improve type safety across the codebase.
+ */
+/**
+ * Type guard to check if error has a message
+ */
+export function isErrorWithMessage(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'message' in error &&
+        typeof error.message === 'string');
+}
+/**
+ * Convert unknown error to Error instance
+ * Use this in catch blocks to safely get an Error object
+ */
+export function toError(error) {
+    if (error instanceof Error)
+        return error;
+    if (isErrorWithMessage(error))
+        return new Error(error.message);
+    try {
+        return new Error(JSON.stringify(error));
+    }
+    catch {
+        return new Error(String(error));
+    }
+}
+/**
+ * Get error message from unknown error
+ * Use this in catch blocks when you just need the message
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (isErrorWithMessage(error))
+        return error.message;
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+}

package/dist/gcs-compatible.d.ts

@@ -0,0 +1,500 @@
+/**
+ * Varity GCS-Compatible Storage Types
+ *
+ * Type definitions for Google Cloud Storage compatible backends including:
+ * - Google Cloud Storage (GCS)
+ * - GCS-compatible APIs
+ * - Migration from GCS to Varity
+ */
+import { StorageResult } from './storage';
+/**
+ * Google Cloud Storage compatible configuration
+ */
+export interface GCSCompatibleConfig {
+    /** GCS endpoint (default: 'storage.googleapis.com') */
+    endpoint?: string;
+    /** Google Cloud project ID */
+    projectId: string;
+    /** Authentication credentials */
+    credentials: GCSCredentials;
+    /** Default bucket name */
+    bucket: string;
+    /** API endpoint override */
+    apiEndpoint?: string;
+    /** Custom user agent */
+    userAgent?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Retry configuration */
+    retry?: {
+        maxRetries: number;
+        initialDelayMs: number;
+        maxDelayMs: number;
+    };
+}
+/**
+ * GCS authentication credentials
+ */
+export interface GCSCredentials {
+    /** Credential type */
+    type: 'service_account' | 'oauth2' | 'api_key' | 'external_account';
+    /** Service account email */
+    clientEmail?: string;
+    /** Service account private key (PEM format) */
+    privateKey?: string;
+    /** Private key ID */
+    privateKeyId?: string;
+    /** OAuth2 access token */
+    accessToken?: string;
+    /** OAuth2 refresh token */
+    refreshToken?: string;
+    /** OAuth2 client ID */
+    clientId?: string;
+    /** OAuth2 client secret */
+    clientSecret?: string;
+    /** Token expiry timestamp */
+    expiryDate?: number;
+    /** API key (for public access) */
+    apiKey?: string;
+    /** External account configuration */
+    externalAccount?: GCSExternalAccountConfig;
+}
+/**
+ * GCS external account configuration (workload identity federation)
+ */
+export interface GCSExternalAccountConfig {
+    /** Audience */
+    audience: string;
+    /** Subject token type */
+    subjectTokenType: string;
+    /** Token URL */
+    tokenUrl: string;
+    /** Service account impersonation URL */
+    serviceAccountImpersonationUrl?: string;
+    /** Credential source */
+    credentialSource: {
+        file?: string;
+        url?: string;
+        headers?: Record<string, string>;
+        format?: {
+            type: 'json' | 'text';
+            subjectTokenFieldName?: string;
+        };
+    };
+}
+/**
+ * GCS upload result
+ */
+export interface GCSUploadResult extends StorageResult {
+    /** Object name in GCS */
+    gcsName: string;
+    /** Bucket name */
+    bucket: string;
+    /** Object generation (version) */
+    generation: string;
+    /** Metadata generation */
+    metageneration: string;
+    /** Content type */
+    contentType: string;
+    /** MD5 hash (base64) */
+    md5Hash: string;
+    /** CRC32C checksum (base64) */
+    crc32c: string;
+    /** Storage class */
+    storageClass?: GCSStorageClass;
+    /** Time created */
+    timeCreated: Date;
+    /** Time updated */
+    updated: Date;
+    /** KMS key name (if encrypted) */
+    kmsKeyName?: string;
+    /** Customer-supplied encryption key SHA256 */
+    customerEncryption?: {
+        encryptionAlgorithm: string;
+        keySha256: string;
+    };
+}
+/**
+ * GCS resumable upload session
+ */
+export interface GCSResumableUpload {
+    /** Resumable upload session URI */
+    sessionUri: string;
+    /** Bucket name */
+    bucket: string;
+    /** Object name */
+    name: string;
+    /** Bytes uploaded so far */
+    uploadedBytes: number;
+    /** Total bytes (if known) */
+    totalBytes?: number;
+    /** Upload ID */
+    uploadId: string;
+    /** Expiration time */
+    expiresAt?: Date;
+}
+/**
+ * Options for GCS resumable upload
+ */
+export interface GCSResumableUploadOptions {
+    /** Chunk size in bytes (must be multiple of 256KB) */
+    chunkSize?: number;
+    /** Content type */
+    contentType?: string;
+    /** Metadata */
+    metadata?: Record<string, string>;
+    /** Predefined ACL */
+    predefinedAcl?: GCSPredefinedACL;
+    /** Storage class */
+    storageClass?: GCSStorageClass;
+    /** Customer-supplied encryption key */
+    encryptionKey?: any;
+    /** KMS key name */
+    kmsKeyName?: string;
+    /** Generation match precondition */
+    ifGenerationMatch?: string;
+    /** Metageneration match precondition */
+    ifMetagenerationMatch?: string;
+}
+/**
+ * GCS list objects response
+ */
+export interface GCSListObjectsResult {
+    /** Array of objects */
+    items: GCSObject[];
+    /** Next page token */
+    nextPageToken?: string;
+    /** Prefixes (for delimiter-based listing) */
+    prefixes?: string[];
+    /** Kind (always 'storage#objects') */
+    kind: string;
+}
+/**
+ * GCS object metadata
+ */
+export interface GCSObject {
+    /** Object name */
+    name: string;
+    /** Bucket name */
+    bucket: string;
+    /** Object generation */
+    generation: string;
+    /** Metadata generation */
+    metageneration: string;
+    /** Size in bytes (as string) */
+    size: string;
+    /** Content type */
+    contentType: string;
+    /** Time created */
+    timeCreated: Date;
+    /** Time updated */
+    updated: Date;
+    /** Time deleted (if soft-deleted) */
+    timeDeleted?: Date;
+    /** MD5 hash (base64) */
+    md5Hash: string;
+    /** CRC32C checksum (base64) */
+    crc32c: string;
+    /** ETag */
+    etag: string;
+    /** Storage class */
+    storageClass: GCSStorageClass;
+    /** Owner */
+    owner?: {
+        entity: string;
+        entityId: string;
+    };
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+    /** ACL */
+    acl?: GCSObjectAccessControl[];
+    /** Content encoding */
+    contentEncoding?: string;
+    /** Content disposition */
+    contentDisposition?: string;
+    /** Content language */
+    contentLanguage?: string;
+    /** Cache control */
+    cacheControl?: string;
+    /** Custom time */
+    customTime?: Date;
+    /** Event-based hold */
+    eventBasedHold?: boolean;
+    /** Temporary hold */
+    temporaryHold?: boolean;
+    /** Retention expiration time */
+    retentionExpirationTime?: Date;
+    /** KMS key name */
+    kmsKeyName?: string;
+    /** Customer encryption */
+    customerEncryption?: {
+        encryptionAlgorithm: string;
+        keySha256: string;
+    };
+}
+/**
+ * GCS object access control
+ */
+export interface GCSObjectAccessControl {
+    /** Kind */
+    kind: string;
+    /** Entity */
+    entity: string;
+    /** Role */
+    role: 'OWNER' | 'READER' | 'WRITER';
+    /** Email */
+    email?: string;
+    /** Entity ID */
+    entityId?: string;
+    /** Domain */
+    domain?: string;
+    /** Project team */
+    projectTeam?: {
+        projectNumber: string;
+        team: string;
+    };
+    /** ETag */
+    etag?: string;
+}
+/**
+ * GCS bucket metadata
+ */
+export interface GCSBucket {
+    /** Bucket name */
+    name: string;
+    /** Bucket location */
+    location: string;
+    /** Storage class */
+    storageClass: GCSStorageClass;
+    /** Time created */
+    timeCreated: Date;
+    /** Time updated */
+    updated: Date;
+    /** Project number */
+    projectNumber: string;
+    /** Metageneration */
+    metageneration: string;
+    /** ETag */
+    etag: string;
+    /** Labels */
+    labels?: Record<string, string>;
+    /** Lifecycle configuration */
+    lifecycle?: GCSBucketLifecycle;
+    /** CORS configuration */
+    cors?: GCSCORSConfiguration[];
+    /** Default event-based hold */
+    defaultEventBasedHold?: boolean;
+    /** Retention policy */
+    retentionPolicy?: GCSRetentionPolicy;
+    /** Versioning */
+    versioning?: {
+        enabled: boolean;
+    };
+    /** Website configuration */
+    website?: {
+        mainPageSuffix?: string;
+        notFoundPage?: string;
+    };
+    /** Logging */
+    logging?: {
+        logBucket: string;
+        logObjectPrefix: string;
+    };
+    /** Encryption */
+    encryption?: {
+        defaultKmsKeyName: string;
+    };
+    /** IAM configuration */
+    iamConfiguration?: {
+        uniformBucketLevelAccess?: {
+            enabled: boolean;
+            lockedTime?: Date;
+        };
+        publicAccessPrevention?: 'enforced' | 'inherited';
+    };
+}
+/**
+ * GCS bucket lifecycle configuration
+ */
+export interface GCSBucketLifecycle {
+    /** Lifecycle rules */
+    rule: GCSLifecycleRule[];
+}
+/**
+ * GCS lifecycle rule
+ */
+export interface GCSLifecycleRule {
+    /** Action */
+    action: {
+        type: 'Delete' | 'SetStorageClass' | 'AbortIncompleteMultipartUpload';
+        storageClass?: GCSStorageClass;
+    };
+    /** Condition */
+    condition: {
+        age?: number;
+        createdBefore?: string;
+        customTimeBefore?: string;
+        daysSinceCustomTime?: number;
+        daysSinceNoncurrentTime?: number;
+        isLive?: boolean;
+        matchesPrefix?: string[];
+        matchesSuffix?: string[];
+        matchesStorageClass?: GCSStorageClass[];
+        noncurrentTimeBefore?: string;
+        numNewerVersions?: number;
+    };
+}
+/**
+ * GCS retention policy
+ */
+export interface GCSRetentionPolicy {
+    /** Retention period in seconds */
+    retentionPeriod: string;
+    /** Effective time */
+    effectiveTime: Date;
+    /** Is locked */
+    isLocked: boolean;
+}
+/**
+ * GCS storage classes
+ */
+export declare enum GCSStorageClass {
+    /** Standard storage */
+    STANDARD = "STANDARD",
+    /** Nearline storage (30-day minimum) */
+    NEARLINE = "NEARLINE",
+    /** Coldline storage (90-day minimum) */
+    COLDLINE = "COLDLINE",
+    /** Archive storage (365-day minimum) */
+    ARCHIVE = "ARCHIVE",
+    /** Durable reduced availability (deprecated) */
+    DURABLE_REDUCED_AVAILABILITY = "DURABLE_REDUCED_AVAILABILITY"
+}
+/**
+ * GCS predefined ACLs
+ */
+export declare enum GCSPredefinedACL {
+    /** Owner gets full control */
+    PRIVATE = "private",
+    /** Owner gets full control, all users get read */
+    PUBLIC_READ = "publicRead",
+    /** Owner gets full control, all users get read and write */
+    PUBLIC_READ_WRITE = "publicReadWrite",
+    /** Owner gets full control, authenticated users get read */
+    AUTHENTICATED_READ = "authenticatedRead",
+    /** Object owner gets full control, bucket owner gets read */
+    BUCKET_OWNER_READ = "bucketOwnerRead",
+    /** Object owner and bucket owner get full control */
+    BUCKET_OWNER_FULL_CONTROL = "bucketOwnerFullControl",
+    /** Project team owners get full control */
+    PROJECT_PRIVATE = "projectPrivate"
+}
+/**
+ * GCS bucket ACL
+ */
+export interface GCSBucketAccessControl {
+    /** Kind */
+    kind: string;
+    /** Entity */
+    entity: string;
+    /** Role */
+    role: 'OWNER' | 'READER' | 'WRITER';
+    /** Email */
+    email?: string;
+    /** Entity ID */
+    entityId?: string;
+    /** Domain */
+    domain?: string;
+    /** Project team */
+    projectTeam?: {
+        projectNumber: string;
+        team: string;
+    };
+    /** ETag */
+    etag?: string;
+}
+/**
+ * GCS CORS configuration
+ */
+export interface GCSCORSConfiguration {
+    /** Max age in seconds */
+    maxAgeSeconds?: number;
+    /** Allowed methods */
+    method?: string[];
+    /** Allowed origins */
+    origin?: string[];
+    /** Response headers */
+    responseHeader?: string[];
+}
+/**
+ * Options for generating signed URLs
+ */
+export interface GCSSignedUrlOptions {
+    /** Expiration time */
+    expires: Date | number;
+    /** HTTP method */
+    method?: 'GET' | 'PUT' | 'POST' | 'DELETE' | 'HEAD';
+    /** Content type */
+    contentType?: string;
+    /** Content MD5 */
+    contentMd5?: string;
+    /** Extension headers */
+    extensionHeaders?: Record<string, string>;
+    /** Query parameters */
+    queryParams?: Record<string, string>;
+    /** Version (v2 or v4) */
+    version?: 'v2' | 'v4';
+    /** Virtual hosted style */
+    virtualHostedStyle?: boolean;
+    /** Bucket-bound hostname */
+    bucketBoundHostname?: string;
+}
+/**
+ * Signed URL result
+ */
+export interface GCSSignedUrl {
+    /** Signed URL */
+    url: string;
+    /** Expiration timestamp */
+    expiresAt: Date;
+    /** HTTP method */
+    method: string;
+}
+/**
+ * GCS notification configuration
+ */
+export interface GCSNotification {
+    /** Notification ID */
+    id: string;
+    /** Topic (Pub/Sub topic) */
+    topic: string;
+    /** Event types */
+    event_types?: string[];
+    /** Custom attributes */
+    custom_attributes?: Record<string, string>;
+    /** Object name prefix */
+    object_name_prefix?: string;
+    /** Payload format */
+    payload_format?: 'JSON_API_V1' | 'NONE';
+    /** ETag */
+    etag?: string;
+}
+/**
+ * GCS customer-supplied encryption key
+ */
+export interface GCSCustomerEncryption {
+    /** Encryption algorithm */
+    encryptionAlgorithm: 'AES256';
+    /** Base64-encoded encryption key */
+    key: string;
+    /** Base64-encoded SHA256 of the key */
+    keySha256: string;
+}
+/**
+ * GCS KMS encryption
+ */
+export interface GCSKMSEncryption {
+    /** KMS key name */
+    kmsKeyName: string;
+}
+//# sourceMappingURL=gcs-compatible.d.ts.map

package/dist/gcs-compatible.d.ts.map

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