@mohasinac/contracts 0.1.0

package/dist/types/shipping.d.ts

@@ -0,0 +1,65 @@
+export interface ShippingAddress {
+    name: string;
+    phone: string;
+    addressLine1: string;
+    addressLine2?: string;
+    city: string;
+    state: string;
+    pincode: string;
+    country: string;
+}
+export interface CreateShipmentInput {
+    orderId: string;
+    dimensions: {
+        weight: number;
+        length: number;
+        width: number;
+        height: number;
+    };
+    pickup: ShippingAddress;
+    delivery: ShippingAddress;
+    codAmount?: number;
+    isCod?: boolean;
+}
+export interface Shipment {
+    id: string;
+    trackingId: string;
+    orderId: string;
+    status: string;
+    courier?: string;
+    estimatedDelivery?: string;
+    createdAt: string;
+}
+export interface TrackingEvent {
+    status: string;
+    location: string;
+    timestamp: string;
+    description?: string;
+}
+export interface TrackingInfo {
+    trackingId: string;
+    currentStatus: string;
+    estimatedDelivery?: string;
+    events: TrackingEvent[];
+}
+export interface ServiceabilityResult {
+    isServiceable: boolean;
+    couriers: Array<{
+        name: string;
+        estimatedDays: number;
+        rate: number;
+    }>;
+}
+/**
+ * Shipping carrier adapter contract.
+ * Implemented by @mohasinac/shipping-shiprocket, @mohasinac/shipping-shippo,
+ * @mohasinac/shipping-easypost.
+ */
+export interface IShippingProvider {
+    createShipment(data: CreateShipmentInput): Promise<Shipment>;
+    trackShipment(trackingId: string): Promise<TrackingInfo>;
+    cancelShipment(shipmentId: string): Promise<void>;
+    checkServiceability(pincode: string, weight: number): Promise<ServiceabilityResult>;
+    generateLabel(shipmentId: string): Promise<ArrayBuffer>;
+}
+//# sourceMappingURL=shipping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.d.ts","sourceRoot":"","sources":["../../src/shipping.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAID;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7D,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzD"}

package/dist/types/storage.d.ts

@@ -0,0 +1,28 @@
+export interface UploadOptions {
+    contentType?: string;
+    cacheControl?: string;
+    /** Make the file publicly accessible (default: true) */
+    isPublic?: boolean;
+    metadata?: Record<string, string>;
+}
+export interface StorageFile {
+    path: string;
+    url: string;
+    contentType: string;
+    size: number;
+    updatedAt: string;
+}
+/**
+ * File storage adapter contract.
+ * Implemented by @mohasinac/storage-firebase, @mohasinac/storage-s3,
+ * @mohasinac/storage-cloudinary, @mohasinac/storage-uploadthing.
+ */
+export interface IStorageProvider {
+    upload(file: Buffer, path: string, options?: UploadOptions): Promise<StorageFile>;
+    delete(path: string): Promise<void>;
+    getPublicUrl(path: string): string;
+    getSignedUrl(path: string, expiresInSeconds?: number): Promise<string>;
+    copy(from: string, to: string): Promise<StorageFile>;
+    list(prefix: string): Promise<StorageFile[]>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/storage.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC9C"}

package/dist/types/style.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CSS framework adapter contract.
+ * UI components call cn()/token() through this adapter, making them
+ * CSS-framework-agnostic.
+ *
+ * Implemented by:
+ *   @mohasinac/css-tailwind  — twMerge + clsx
+ *   @mohasinac/css-vanilla   — plain string join
+ *   @mohasinac/css-emotion   — Emotion cx()
+ *   @mohasinac/css-modules   — CSS Modules
+ */
+export interface IStyleAdapter {
+    /**
+     * Merges and deduplicates class names.
+     * Equivalent to twMerge(clsx(...)) in Tailwind projects.
+     */
+    cn(...classes: Array<string | undefined | null | false>): string;
+    /**
+     * Resolves a design token name to a CSS custom property reference.
+     * e.g. token("color-primary") → "var(--lir-color-primary)"
+     */
+    token(name: string): string;
+}
+//# sourceMappingURL=style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/style.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,EAAE,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC;IACjE;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@mohasinac/contracts",
+  "version": "0.1.0",
+  "description": "All TypeScript interfaces and shared types for @mohasinac/* packages — no concrete code",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "lint": "eslint src"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "eslint": "^9.37.0"
+  }
+}