@mohasinac/appkit 2.1.3 → 2.3.0

package/src/providers/payment-razorpay/index.ts

@@ -1,165 +0,0 @@
-/**
- * @mohasinac/payment-razorpay — Razorpay IPaymentProvider implementation
- *
- * Implements the @mohasinac/contracts IPaymentProvider interface.
- * Accepts credentials via constructor — no Firestore or DB dependency.
- *
- * @example
- * ```ts
- * import { RazorpayProvider } from "@mohasinac/payment-razorpay";
- * import { registerProviders } from "../../contracts";
- *
- * registerProviders({
- *   payment: new RazorpayProvider({
- *     keyId: process.env.RAZORPAY_KEY_ID!,
- *     keySecret: process.env.RAZORPAY_KEY_SECRET!,
- *     webhookSecret: process.env.RAZORPAY_WEBHOOK_SECRET,
- *   }),
- * });
- * ```
- */
-
-import Razorpay from "razorpay";
-import { createHmac, timingSafeEqual } from "crypto";
-import type {
-  IPaymentProvider,
-  PaymentOrder,
-  PaymentCapture,
-  Refund,
-} from "../../contracts";
-
-export interface RazorpayConfig {
-  keyId: string;
-  keySecret: string;
-  webhookSecret?: string;
-}
-
-// ─── IPaymentProvider implementation ──────────────────────────────────────────
-
-export class RazorpayProvider implements IPaymentProvider {
-  private readonly razorpay: Razorpay;
-  private readonly webhookSecret?: string;
-
-  constructor(config: RazorpayConfig) {
-    this.razorpay = new Razorpay({
-      key_id: config.keyId,
-      key_secret: config.keySecret,
-    });
-    this.webhookSecret = config.webhookSecret;
-  }
-
-  async createOrder(
-    amount: number,
-    currency = "INR",
-    metadata?: Record<string, unknown>,
-  ): Promise<PaymentOrder> {
-    const order = await this.razorpay.orders.create({
-      amount,
-      currency,
-      notes: metadata as Record<string, string> | undefined,
-    });
-    return {
-      id: String(order.id),
-      amount: Number(order.amount),
-      currency: String(order.currency),
-      status: "created",
-      receipt: order.receipt ?? undefined,
-      metadata,
-      createdAt: new Date(Number(order.created_at) * 1000).toISOString(),
-    };
-  }
-
-  /**
-   * Verify Razorpay webhook signature (HMAC-SHA256 over raw body).
-   * Requires webhookSecret to be set in the constructor.
-   */
-  verifyWebhook(payload: string, signature: string): boolean {
-    if (!this.webhookSecret) return false;
-    const expected = createHmac("sha256", this.webhookSecret)
-      .update(payload)
-      .digest("hex");
-    if (signature.length !== 64 || expected.length !== 64) return false;
-    return timingSafeEqual(
-      Buffer.from(expected, "hex"),
-      Buffer.from(signature, "hex"),
-    );
-  }
-
-  async capturePayment(paymentId: string): Promise<PaymentCapture> {
-    const payment = await this.razorpay.payments.fetch(paymentId);
-    return {
-      id: String(payment.id),
-      orderId: String(payment.order_id ?? ""),
-      amount: Number(payment.amount),
-      currency: String(payment.currency),
-      status: payment.status === "captured" ? "captured" : "failed",
-      capturedAt: new Date().toISOString(),
-    };
-  }
-
-  async refund(paymentId: string, amount?: number): Promise<Refund> {
-    const refundData: Record<string, unknown> = {};
-    if (amount !== undefined) refundData.amount = amount;
-    const result = await this.razorpay.payments.refund(
-      paymentId,
-      refundData as Parameters<typeof this.razorpay.payments.refund>[1],
-    );
-    return {
-      id: String(result.id),
-      paymentId,
-      amount: Number(result.amount),
-      currency: String(result.currency),
-      status: result.status === "processed" ? "processed" : "pending",
-      createdAt: new Date(Number(result.created_at) * 1000).toISOString(),
-    };
-  }
-
-  async getOrder(orderId: string): Promise<PaymentOrder> {
-    const order = await this.razorpay.orders.fetch(orderId);
-    return {
-      id: String(order.id),
-      amount: Number(order.amount),
-      currency: String(order.currency),
-      status: "created",
-      receipt: order.receipt ?? undefined,
-      createdAt: new Date(Number(order.created_at) * 1000).toISOString(),
-    };
-  }
-}
-
-// ─── Utility exports ──────────────────────────────────────────────────────────
-
-/** Convert rupees (float) → paise (integer) for Razorpay amount field */
-export function rupeesToPaise(rupees: number): number {
-  return Math.round(rupees * 100);
-}
-
-/** Convert paise (integer) → rupees (float) */
-export function paiseToRupees(paise: number): number {
-  return paise / 100;
-}
-
-export interface RazorpayPaymentResult {
-  razorpay_order_id: string;
-  razorpay_payment_id: string;
-  razorpay_signature: string;
-}
-
-/**
- * Verify Razorpay payment signature.
- * Uses HMAC-SHA256 over `{orderId}|{paymentId}` with the key secret.
- */
-export function verifyPaymentSignature(
-  params: RazorpayPaymentResult,
-  keySecret: string,
-): boolean {
-  if (!keySecret) return false;
-  const expected = createHmac("sha256", keySecret)
-    .update(`${params.razorpay_order_id}|${params.razorpay_payment_id}`)
-    .digest("hex");
-  if (params.razorpay_signature.length !== 64) return false;
-  return timingSafeEqual(
-    Buffer.from(expected, "hex"),
-    Buffer.from(params.razorpay_signature, "hex"),
-  );
-}

package/src/providers/shipping-shiprocket/index.ts

@@ -1,402 +0,0 @@
-/**
- * @mohasinac/shipping-shiprocket — Shiprocket shipping API client
- *
- * Thin HTTP client for the Shiprocket REST API.
- * No credential management — caller is responsible for obtaining and
- * passing the JWT token (see your project's platform auth layer).
- *
- * API base: https://apiv2.shiprocket.in/v1/external
- *
- * @example
- * ```ts
- * import {
- *   shiprocketAuthenticate,
- *   shiprocketCreateOrder,
- *   shiprocketTrackByAWB,
- * } from "@mohasinac/shipping-shiprocket";
- *
- * const { token } = await shiprocketAuthenticate({ email, password });
- * const order = await shiprocketCreateOrder(token, orderData);
- * ```
- */
-
-const BASE_URL = "https://apiv2.shiprocket.in/v1/external";
-
-// ─── Types ─────────────────────────────────────────────────────────────────────
-
-export interface ShiprocketAuthRequest {
-  email: string;
-  password: string;
-}
-
-export interface ShiprocketAuthResponse {
-  token: string;
-  message: string;
-  data?: { id: number; email: string; name: string; company_id: number };
-}
-
-export interface ShiprocketPickupLocation {
-  id: number;
-  pickup_location: string;
-  add: string;
-  add2?: string;
-  city: string;
-  state: string;
-  country: string;
-  pin_code: string;
-  phone: string;
-  email: string;
-  name: string;
-  phone_verified?: number;
-}
-
-export interface ShiprocketPickupLocationsResponse {
-  shipping_address: ShiprocketPickupLocation[];
-}
-
-export interface ShiprocketAddPickupRequest {
-  pickup_location: string;
-  name: string;
-  email: string;
-  phone: string;
-  address: string;
-  address_2?: string;
-  city: string;
-  state: string;
-  country: string;
-  pin_code: string;
-}
-
-export interface ShiprocketAddPickupResponse {
-  success: boolean;
-  address?: {
-    pickup_location_id: number;
-    name: string;
-    phone: string;
-    address: string;
-    city: string;
-    state: string;
-    country: string;
-    pin_code: string;
-  };
-  message?: string;
-}
-
-export interface ShiprocketVerifyPickupOTPRequest {
-  otp: number;
-  pickup_location_id: number;
-}
-
-export interface ShiprocketVerifyPickupOTPResponse {
-  success: boolean;
-  message: string;
-}
-
-export interface ShiprocketOrderItem {
-  name: string;
-  sku: string;
-  units: number;
-  selling_price: number;
-  discount?: number;
-  tax?: string;
-  hsn?: number;
-}
-
-export interface ShiprocketCreateOrderRequest {
-  order_id: string;
-  order_date: string;
-  pickup_location: string;
-  billing_customer_name: string;
-  billing_last_name?: string;
-  billing_address: string;
-  billing_address_2?: string;
-  billing_city: string;
-  billing_pincode: string;
-  billing_state: string;
-  billing_country: string;
-  billing_email: string;
-  billing_phone: string;
-  shipping_is_billing: boolean;
-  shipping_customer_name?: string;
-  shipping_last_name?: string;
-  shipping_address?: string;
-  shipping_address_2?: string;
-  shipping_city?: string;
-  shipping_pincode?: string;
-  shipping_state?: string;
-  shipping_country?: string;
-  shipping_phone?: string;
-  order_items: ShiprocketOrderItem[];
-  payment_method: "Prepaid" | "COD";
-  sub_total: number;
-  length: number;
-  breadth: number;
-  height: number;
-  weight: number;
-}
-
-export interface ShiprocketCreateOrderResponse {
-  order_id: number;
-  shipment_id: number;
-  status: string;
-  status_code: number;
-  onboarding_completed_now: boolean;
-  awb_code?: string;
-  courier_company_id?: number;
-  courier_name?: string;
-}
-
-export interface ShiprocketGenerateAWBRequest {
-  shipment_id: number;
-  courier_id?: number;
-}
-
-export interface ShiprocketAWBResponse {
-  awb_code: string;
-  courier_company_id: number;
-  courier_name: string;
-  shipment_id: number;
-  assigned_date_time: string;
-  expected_delivery: string;
-  tracking_url?: string;
-}
-
-export interface ShiprocketGeneratePickupRequest {
-  shipment_id: number[];
-  pickup_date?: string[];
-}
-
-export interface ShiprocketPickupResponse {
-  pickup_scheduled_date?: string;
-  pickup_token_number?: string;
-  status: number;
-  others?: string;
-}
-
-export interface ShiprocketTrackActivity {
-  date: string;
-  status: string;
-  activity: string;
-  location: string;
-  sr_status?: string;
-  sr_status_label?: string;
-}
-
-export interface ShiprocketShipmentTrack {
-  id: number;
-  awb_code: string;
-  courier_company_id: number;
-  shipment_id: number;
-  order_id: number;
-  pickup_date?: string;
-  delivered_date?: string;
-  weight: string;
-  current_status: string;
-  edd?: string;
-  shipment_track_activities: ShiprocketTrackActivity[];
-}
-
-export interface ShiprocketTrackingResponse {
-  tracking_data: {
-    awb_track_url: string;
-    track_url: string;
-    current_status: string;
-    current_status_id: number;
-    shipment_status: number;
-    shipment_track: ShiprocketShipmentTrack[];
-    shipment_track_activities: ShiprocketTrackActivity[];
-    error?: string;
-    cod?: boolean;
-  };
-}
-
-export interface ShiprocketCourierServiceabilityResponse {
-  data?: {
-    available_courier_companies: Array<{
-      id: number;
-      name: string;
-      etd: string;
-      rate: number;
-      cod_charges?: number;
-    }>;
-  };
-  status: number;
-  message?: string;
-}
-
-export interface ShiprocketWebhookPayload {
-  awb: string;
-  order_id: string;
-  shipment_id: string;
-  current_status: string;
-  current_status_id: number;
-  courier_agent_assigned?: boolean;
-  etd?: string;
-  pickup_generated?: boolean;
-}
-
-// ─── Internal fetch helper ────────────────────────────────────────────────────
-
-async function shiprocketFetch<T>(
-  endpoint: string,
-  options: Omit<RequestInit, "headers"> & {
-    token?: string;
-    headers?: Record<string, string>;
-  } = {},
-): Promise<T> {
-  const { token, headers = {}, ...rest } = options;
-  const reqHeaders: Record<string, string> = {
-    "Content-Type": "application/json",
-    ...headers,
-  };
-  if (token) reqHeaders["Authorization"] = `Bearer ${token}`;
-
-  const response = await fetch(`${BASE_URL}${endpoint}`, {
-    ...rest,
-    headers: reqHeaders,
-  });
-
-  const text = await response.text();
-  let json: unknown;
-  try {
-    json = JSON.parse(text);
-  } catch {
-    throw new Error(
-      `Shiprocket API non-JSON response ${response.status}: ${text.slice(0, 200)}`,
-    );
-  }
-
-  if (!response.ok) {
-    const message =
-      (json as { message?: string })?.message ??
-      `Shiprocket API error ${response.status}`;
-    throw new Error(message);
-  }
-
-  return json as T;
-}
-
-// ─── API Functions ────────────────────────────────────────────────────────────
-
-export async function shiprocketAuthenticate(
-  credentials: ShiprocketAuthRequest,
-): Promise<ShiprocketAuthResponse> {
-  return shiprocketFetch<ShiprocketAuthResponse>("/auth/login", {
-    method: "POST",
-    body: JSON.stringify(credentials),
-  });
-}
-
-export async function shiprocketGetPickupLocations(
-  token: string,
-): Promise<ShiprocketPickupLocationsResponse> {
-  return shiprocketFetch<ShiprocketPickupLocationsResponse>(
-    "/settings/company/pickup",
-    { token },
-  );
-}
-
-export async function shiprocketAddPickupLocation(
-  token: string,
-  data: ShiprocketAddPickupRequest,
-): Promise<ShiprocketAddPickupResponse> {
-  return shiprocketFetch<ShiprocketAddPickupResponse>(
-    "/settings/company/addpickup",
-    { method: "POST", token, body: JSON.stringify(data) },
-  );
-}
-
-export async function shiprocketVerifyPickupOTP(
-  token: string,
-  data: ShiprocketVerifyPickupOTPRequest,
-): Promise<ShiprocketVerifyPickupOTPResponse> {
-  return shiprocketFetch<ShiprocketVerifyPickupOTPResponse>(
-    "/settings/company/verifyOtpForPickup",
-    { method: "POST", token, body: JSON.stringify(data) },
-  );
-}
-
-export async function shiprocketCreateOrder(
-  token: string,
-  order: ShiprocketCreateOrderRequest,
-): Promise<ShiprocketCreateOrderResponse> {
-  return shiprocketFetch<ShiprocketCreateOrderResponse>(
-    "/orders/create/adhoc",
-    { method: "POST", token, body: JSON.stringify(order) },
-  );
-}
-
-export async function shiprocketGenerateAWB(
-  token: string,
-  params: ShiprocketGenerateAWBRequest,
-): Promise<ShiprocketAWBResponse> {
-  return shiprocketFetch<ShiprocketAWBResponse>("/courier/assign/awb", {
-    method: "POST",
-    token,
-    body: JSON.stringify(params),
-  });
-}
-
-export async function shiprocketGeneratePickup(
-  token: string,
-  params: ShiprocketGeneratePickupRequest,
-): Promise<ShiprocketPickupResponse> {
-  return shiprocketFetch<ShiprocketPickupResponse>("/courier/generate/pickup", {
-    method: "POST",
-    token,
-    body: JSON.stringify(params),
-  });
-}
-
-export async function shiprocketTrackByAWB(
-  token: string,
-  awb: string,
-): Promise<ShiprocketTrackingResponse> {
-  return shiprocketFetch<ShiprocketTrackingResponse>(
-    `/courier/track/awb/${awb}`,
-    { token },
-  );
-}
-
-export async function shiprocketCheckServiceability(
-  token: string,
-  paramsOrPickup:
-    | {
-        pickup_postcode: string;
-        delivery_postcode: string;
-        weight: number;
-        cod?: 0 | 1;
-      }
-    | string,
-  deliveryPostcode?: string,
-  weight?: number,
-  cod = false,
-): Promise<ShiprocketCourierServiceabilityResponse> {
-  const params =
-    typeof paramsOrPickup === "string"
-      ? {
-          pickup_postcode: paramsOrPickup,
-          delivery_postcode: deliveryPostcode ?? "",
-          weight: weight ?? 0,
-          cod: cod ? 1 : 0,
-        }
-      : paramsOrPickup;
-
-  const sp = new URLSearchParams();
-  sp.set("pickup_postcode", params.pickup_postcode);
-  sp.set("delivery_postcode", params.delivery_postcode);
-  sp.set("weight", String(params.weight));
-  if (params.cod !== undefined) sp.set("cod", String(params.cod));
-  return shiprocketFetch<ShiprocketCourierServiceabilityResponse>(
-    `/courier/serviceability/?${sp.toString()}`,
-    { token },
-  );
-}
-
-/** Shiprocket tokens are valid for approx. 10 days */
-export const SHIPROCKET_TOKEN_TTL_MS = 9 * 24 * 60 * 60 * 1000;
-
-export function isShiprocketTokenExpired(expiry: Date | undefined): boolean {
-  if (!expiry) return true;
-  return new Date() >= new Date(expiry);
-}

package/src/providers/storage-firebase/index.ts

@@ -1,17 +0,0 @@
-/**
- * @mohasinac/storage-firebase
- *
- * Firebase Storage (Admin SDK) implementation of `IStorageProvider`
- * from `@mohasinac/contracts`.
- *
- * @example
- * ```ts
- * import { firebaseStorageProvider } from "@mohasinac/storage-firebase";
- *
- * const result = await firebaseStorageProvider.upload(
- *   buffer, "products/image.jpg", { contentType: "image/jpeg" }
- * );
- * ```
- */
-
-export { firebaseStorageProvider } from "./provider";

package/src/providers/storage-firebase/provider.ts

@@ -1,131 +0,0 @@
-/**
- * firebaseStorageProvider — IStorageProvider
- *
- * Implements `@mohasinac/contracts` `IStorageProvider` using the Firebase Admin SDK
- * Cloud Storage.  Server-side only.
- *
- * All operations target the default storage bucket configured via
- * `FIREBASE_ADMIN_STORAGE_BUCKET` or `NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET`.
- *
- * @example
- * ```ts
- * import { firebaseStorageProvider } from "@mohasinac/storage-firebase";
- *
- * const file = await firebaseStorageProvider.upload(
- *   buffer,
- *   "products/abc123.jpg",
- *   { contentType: "image/jpeg" }
- * );
- * console.log(file.url); // Public download URL
- * ```
- */
-
-import type {
-  IStorageProvider,
-  StorageFile,
-  UploadOptions,
-} from "../../contracts";
-import { getAdminStorageLite } from "../db-firebase/admin-storage-lite";
-
-function getBucket() {
-  const bucketName =
-    process.env.FIREBASE_ADMIN_STORAGE_BUCKET?.trim() ??
-    process.env.NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET?.trim();
-  return bucketName
-    ? getAdminStorageLite().bucket(bucketName)
-    : getAdminStorageLite().bucket();
-}
-
-export const firebaseStorageProvider: IStorageProvider = {
-  async upload(
-    file: Buffer,
-    storagePath: string,
-    options?: UploadOptions,
-  ): Promise<StorageFile> {
-    const bucket = getBucket();
-    const fileRef = bucket.file(storagePath);
-
-    await fileRef.save(file, {
-      metadata: {
-        contentType: options?.contentType ?? "application/octet-stream",
-        cacheControl: options?.cacheControl ?? "public, max-age=31536000",
-        metadata: options?.metadata ?? {},
-      },
-      public: options?.isPublic !== false,
-    });
-
-    const [metadata] = await fileRef.getMetadata();
-
-    const url =
-      options?.isPublic !== false
-        ? `https://storage.googleapis.com/${bucket.name}/${storagePath}`
-        : await fileRef
-            .getSignedUrl({
-              action: "read",
-              expires: Date.now() + 60 * 60 * 1000, // 1 hour
-            })
-            .then(([u]) => u);
-
-    return {
-      path: storagePath,
-      url,
-      contentType: metadata.contentType as string,
-      size: Number(metadata.size),
-      updatedAt: metadata.updated as string,
-    };
-  },
-
-  async delete(storagePath: string): Promise<void> {
-    await getBucket().file(storagePath).delete({ ignoreNotFound: true });
-  },
-
-  getPublicUrl(storagePath: string): string {
-    const bucket = getBucket();
-    return `https://storage.googleapis.com/${bucket.name}/${storagePath}`;
-  },
-
-  async getSignedUrl(
-    storagePath: string,
-    expiresInSeconds = 3600,
-  ): Promise<string> {
-    const [url] = await getBucket()
-      .file(storagePath)
-      .getSignedUrl({
-        action: "read",
-        expires: Date.now() + expiresInSeconds * 1000,
-      });
-    return url;
-  },
-
-  async copy(from: string, to: string): Promise<StorageFile> {
-    const bucket = getBucket();
-    const src = bucket.file(from);
-    const dest = bucket.file(to);
-    await src.copy(dest);
-    const [metadata] = await dest.getMetadata();
-    return {
-      path: to,
-      url: `https://storage.googleapis.com/${bucket.name}/${to}`,
-      contentType: metadata.contentType as string,
-      size: Number(metadata.size),
-      updatedAt: metadata.updated as string,
-    };
-  },
-
-  async list(prefix: string): Promise<StorageFile[]> {
-    const bucket = getBucket();
-    const [files] = await bucket.getFiles({ prefix });
-    return Promise.all(
-      files.map(async (f) => {
-        const [metadata] = await f.getMetadata();
-        return {
-          path: f.name,
-          url: `https://storage.googleapis.com/${bucket.name}/${f.name}`,
-          contentType: metadata.contentType as string,
-          size: Number(metadata.size),
-          updatedAt: metadata.updated as string,
-        };
-      }),
-    );
-  },
-};