persian-data-grid 0.5.0 → 0.7.0

package/dist/VazirmatnPdfRenderer-CpCqA-Wh.d.cts

@@ -0,0 +1,96 @@
+import { G as GridPlugin, a as GridPluginContext, E as ExportSource } from './GridPlugin-DewWufGZ.cjs';
+import { P as PdfRenderer, a as PdfRenderOptions } from './PdfRenderer-B9FJaCo_.cjs';
+
+/**
+ * Document PDF template options (PR-141).
+ * Consumed by {@link VazirmatnPdfRenderer} for ERP voucher-style output.
+ */
+type DocumentPdfLogo = {
+    /** Raw JPEG bytes (DCTDecode). PNG is not supported in this slice. */
+    jpegBytes: Uint8Array;
+    /** Display width in PDF points. Default 64. */
+    width?: number;
+    /** Display height in PDF points. Default 48. */
+    height?: number;
+};
+type DocumentPdfHeader = {
+    /** Primary header title (defaults to render `title` option). */
+    title?: string;
+    subtitle?: string;
+    /** Extra meta lines (doc no, date, …). */
+    meta?: readonly string[];
+};
+type DocumentPdfFooter = {
+    text?: string;
+    /** Default true when a template is provided. */
+    showPageNumber?: boolean;
+    /** Tokens: `{page}` `{pages}`. Default `{page} / {pages}`. */
+    pageNumberFormat?: string;
+};
+type DocumentPdfSignature = {
+    label?: string;
+    /** Blank ruled lines under the label. Default 2. */
+    lines?: number;
+};
+type DocumentPdfStamp = {
+    label?: string;
+};
+type DocumentPdfPageTotals = {
+    /** Column fieldNames to sum on each page (price/number). */
+    columns: readonly string[];
+    label?: string;
+};
+/**
+ * ERP document chrome for Persian PDF export.
+ * When omitted, {@link VazirmatnPdfRenderer} keeps the simple title + table layout.
+ */
+type DocumentPdfTemplate = {
+    header?: DocumentPdfHeader;
+    footer?: DocumentPdfFooter;
+    logo?: DocumentPdfLogo;
+    /** Repeat column headers on every page. Default true. */
+    repeatTableHeader?: boolean;
+    signature?: DocumentPdfSignature;
+    stamp?: DocumentPdfStamp;
+    pageTotals?: DocumentPdfPageTotals;
+};
+
+type PdfExportPluginOptions = {
+    renderer?: PdfRenderer;
+    download?: boolean;
+    /** Document chrome for VazirmatnPdfRenderer (PR-141). */
+    template?: DocumentPdfTemplate;
+    onBlob?: (blob: Blob, meta: {
+        fileName: string;
+        rowCount: number;
+    }) => void;
+};
+/**
+ * Subscribes to EXPORT_REQUESTED (format=pdf); Domain stays untouched.
+ *
+ * Default renderer is legacy `TextPdfRenderer` so `./plugins/pdf` stays free of
+ * font bytes (PR-76 / D15). For Persian PDF:
+ * `import { createVazirmatnPdfExportPlugin } from 'persian-data-grid/plugins/pdf/fonts/vazirmatn'`.
+ */
+declare class PdfExportPlugin implements GridPlugin {
+    private readonly options;
+    readonly name = "pdf-export";
+    private unsub;
+    private readonly renderer;
+    constructor(options?: PdfExportPluginOptions);
+    register(ctx: GridPluginContext): void;
+    dispose(): void;
+    private onEvent;
+}
+
+/**
+ * Persian table PDF: embeds Vazirmatn (OFL) as CIDFontType2, RTL grid, no 8×40 cap.
+ * PR-141: optional {@link DocumentPdfTemplate} for document chrome.
+ */
+declare class VazirmatnPdfRenderer implements PdfRenderer {
+    private readonly fontBytes;
+    constructor(fontBytes: Uint8Array);
+    render(source: ExportSource, options?: PdfRenderOptions): Promise<Blob>;
+}
+
+export { type DocumentPdfFooter as D, type PdfExportPluginOptions as P, VazirmatnPdfRenderer as V, PdfExportPlugin as a, type DocumentPdfHeader as b, type DocumentPdfLogo as c, type DocumentPdfPageTotals as d, type DocumentPdfSignature as e, type DocumentPdfStamp as f, type DocumentPdfTemplate as g };

package/dist/VazirmatnPdfRenderer-D46smncn.d.ts

@@ -0,0 +1,96 @@
+import { G as GridPlugin, a as GridPluginContext, E as ExportSource } from './GridPlugin-Bewn0X51.js';
+import { P as PdfRenderer, a as PdfRenderOptions } from './PdfRenderer-bN7ca_Aj.js';
+
+/**
+ * Document PDF template options (PR-141).
+ * Consumed by {@link VazirmatnPdfRenderer} for ERP voucher-style output.
+ */
+type DocumentPdfLogo = {
+    /** Raw JPEG bytes (DCTDecode). PNG is not supported in this slice. */
+    jpegBytes: Uint8Array;
+    /** Display width in PDF points. Default 64. */
+    width?: number;
+    /** Display height in PDF points. Default 48. */
+    height?: number;
+};
+type DocumentPdfHeader = {
+    /** Primary header title (defaults to render `title` option). */
+    title?: string;
+    subtitle?: string;
+    /** Extra meta lines (doc no, date, …). */
+    meta?: readonly string[];
+};
+type DocumentPdfFooter = {
+    text?: string;
+    /** Default true when a template is provided. */
+    showPageNumber?: boolean;
+    /** Tokens: `{page}` `{pages}`. Default `{page} / {pages}`. */
+    pageNumberFormat?: string;
+};
+type DocumentPdfSignature = {
+    label?: string;
+    /** Blank ruled lines under the label. Default 2. */
+    lines?: number;
+};
+type DocumentPdfStamp = {
+    label?: string;
+};
+type DocumentPdfPageTotals = {
+    /** Column fieldNames to sum on each page (price/number). */
+    columns: readonly string[];
+    label?: string;
+};
+/**
+ * ERP document chrome for Persian PDF export.
+ * When omitted, {@link VazirmatnPdfRenderer} keeps the simple title + table layout.
+ */
+type DocumentPdfTemplate = {
+    header?: DocumentPdfHeader;
+    footer?: DocumentPdfFooter;
+    logo?: DocumentPdfLogo;
+    /** Repeat column headers on every page. Default true. */
+    repeatTableHeader?: boolean;
+    signature?: DocumentPdfSignature;
+    stamp?: DocumentPdfStamp;
+    pageTotals?: DocumentPdfPageTotals;
+};
+
+type PdfExportPluginOptions = {
+    renderer?: PdfRenderer;
+    download?: boolean;
+    /** Document chrome for VazirmatnPdfRenderer (PR-141). */
+    template?: DocumentPdfTemplate;
+    onBlob?: (blob: Blob, meta: {
+        fileName: string;
+        rowCount: number;
+    }) => void;
+};
+/**
+ * Subscribes to EXPORT_REQUESTED (format=pdf); Domain stays untouched.
+ *
+ * Default renderer is legacy `TextPdfRenderer` so `./plugins/pdf` stays free of
+ * font bytes (PR-76 / D15). For Persian PDF:
+ * `import { createVazirmatnPdfExportPlugin } from 'persian-data-grid/plugins/pdf/fonts/vazirmatn'`.
+ */
+declare class PdfExportPlugin implements GridPlugin {
+    private readonly options;
+    readonly name = "pdf-export";
+    private unsub;
+    private readonly renderer;
+    constructor(options?: PdfExportPluginOptions);
+    register(ctx: GridPluginContext): void;
+    dispose(): void;
+    private onEvent;
+}
+
+/**
+ * Persian table PDF: embeds Vazirmatn (OFL) as CIDFontType2, RTL grid, no 8×40 cap.
+ * PR-141: optional {@link DocumentPdfTemplate} for document chrome.
+ */
+declare class VazirmatnPdfRenderer implements PdfRenderer {
+    private readonly fontBytes;
+    constructor(fontBytes: Uint8Array);
+    render(source: ExportSource, options?: PdfRenderOptions): Promise<Blob>;
+}
+
+export { type DocumentPdfFooter as D, type PdfExportPluginOptions as P, VazirmatnPdfRenderer as V, PdfExportPlugin as a, type DocumentPdfHeader as b, type DocumentPdfLogo as c, type DocumentPdfPageTotals as d, type DocumentPdfSignature as e, type DocumentPdfStamp as f, type DocumentPdfTemplate as g };

package/dist/adapters/arian-erp.cjs

@@ -0,0 +1,89 @@
+'use strict';
+
+var chunkE2J533UH_cjs = require('../chunk-E2J533UH.cjs');
+
+// infrastructure/Repositories/fetchRemoteApi.ts
+function readCookie(name) {
+  if (typeof document === "undefined") return "";
+  const cookies = document.cookie.split(";");
+  const cookie = cookies.find((item) => item.trim().startsWith(`${name}=`));
+  if (!cookie) return "";
+  return cookie.trim().slice(name.length + 1);
+}
+function readErpDefaults() {
+  if (typeof window === "undefined") return {};
+  try {
+    const storage = localStorage.getItem("persist:arianERP");
+    const parsedStorage = JSON.parse(storage ?? "{}");
+    const parsedConfig = JSON.parse(parsedStorage.config ?? "{}");
+    return parsedConfig.defaultConfigs ?? {};
+  } catch {
+    return {};
+  }
+}
+function joinUrl(baseUrl, endpoint) {
+  if (/^https?:\/\//i.test(endpoint)) return endpoint;
+  const base = baseUrl.replace(/\/$/, "");
+  const path = endpoint.startsWith("/") ? endpoint : `/${endpoint}`;
+  return `${base}${path}`;
+}
+var FetchRemoteApi = class {
+  constructor(err, options = {}) {
+    this.err = err;
+    this.options = options;
+  }
+  async request(input) {
+    try {
+      const defaults = this.options.getDefaults?.() ?? readErpDefaults();
+      const token = this.options.getToken ? this.options.getToken() ?? "" : readCookie("_auth");
+      const method = input.method ?? "POST";
+      const url = joinUrl(this.options.baseUrl ?? "", input.endpoint);
+      const payload = method === "GET" ? void 0 : {
+        ...input.params ?? {},
+        Defaults: {
+          CurrencyId: defaults.CurrencyId?.id,
+          CashierId: defaults.CashierId?.id,
+          PlaceId: defaults.PlaceId?.id,
+          YearId: defaults.YearId?.id,
+          LangId: defaults.LanguageId?.id
+        }
+      };
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (token) headers.Authorization = `Bearer ${token}`;
+      const res = await (this.options.fetcher ?? fetch)(url, {
+        method,
+        headers,
+        body: payload ? JSON.stringify(payload) : void 0
+      });
+      if (!res.ok) {
+        throw new Error(
+          `RemoteApi request failed: HTTP ${res.status} ${input.endpoint}`
+        );
+      }
+      try {
+        return await res.json();
+      } catch {
+        throw new Error(
+          `RemoteApi response is not valid JSON: HTTP ${res.status} ${input.endpoint}`
+        );
+      }
+    } catch (error) {
+      this.err?.handle(error, "FetchRemoteApi.request");
+      throw error;
+    }
+  }
+};
+
+Object.defineProperty(exports, "CallbackRemoteApi", {
+  enumerable: true,
+  get: function () { return chunkE2J533UH_cjs.CallbackRemoteApi; }
+});
+Object.defineProperty(exports, "createBaseQueryRemoteApi", {
+  enumerable: true,
+  get: function () { return chunkE2J533UH_cjs.createBaseQueryRemoteApi; }
+});
+exports.FetchRemoteApi = FetchRemoteApi;
+//# sourceMappingURL=arian-erp.cjs.map
+//# sourceMappingURL=arian-erp.cjs.map

package/dist/adapters/arian-erp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../infrastructure/Repositories/fetchRemoteApi.ts"],"names":[],"mappings":"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","file":"arian-erp.cjs","sourcesContent":["import { EngineErrorHandler } from '../../engine/EngineErrorHandler';\nimport { RemoteApi } from '../../application/ports/RemoteApi';\n\nexport type ErpDefaults = {\n  PlaceId?: { id?: number };\n  YearId?: { id?: number };\n  LanguageId?: { id?: number };\n  CashierId?: { id?: number };\n  CurrencyId?: { id?: number };\n};\n\nfunction readCookie(name: string): string {\n  if (typeof document === 'undefined') return '';\n  const cookies = document.cookie.split(';');\n  const cookie = cookies.find((item) => item.trim().startsWith(`${name}=`));\n  if (!cookie) return '';\n  return cookie.trim().slice(name.length + 1);\n}\n\nfunction readErpDefaults(): ErpDefaults {\n  if (typeof window === 'undefined') return {};\n  try {\n    const storage = localStorage.getItem('persist:arianERP');\n    const parsedStorage = JSON.parse(storage ?? '{}');\n    const parsedConfig = JSON.parse(parsedStorage.config ?? '{}');\n    return parsedConfig.defaultConfigs ?? {};\n  } catch {\n    return {};\n  }\n}\n\nfunction joinUrl(baseUrl: string, endpoint: string): string {\n  if (/^https?:\\/\\//i.test(endpoint)) return endpoint;\n  const base = baseUrl.replace(/\\/$/, '');\n  const path = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;\n  return `${base}${path}`;\n}\n\n/**\n * Host-injected RemoteApi for arianERP.\n * Not the package default — pass `remoteApi={new FetchRemoteApi()}` from the ERP host.\n * Reads auth cookie `_auth` and redux-persist `persist:arianERP`, then POSTs JSON\n * (relative URLs work on the ERP host).\n * Non-2xx responses and non-JSON bodies reject with an `Error` naming the HTTP\n * status and endpoint (also reported through the optional error handler).\n * See `examples/host-arian-erp/host-arian-erp.md`.\n */\nexport type FetchRemoteApiOptions = {\n  baseUrl?: string;\n  /** Inject the bearer token (e.g. from the host's auth store). Default: cookie `_auth`. */\n  getToken?: () => string | undefined | null;\n  /** Inject ERP defaults (e.g. from Redux). Default: localStorage `persist:arianERP`. */\n  getDefaults?: () => ErpDefaults;\n  /** Custom fetch (tests, interceptors, token refresh). Default: global `fetch`. */\n  fetcher?: typeof fetch;\n};\n\nexport class FetchRemoteApi implements RemoteApi {\n  constructor(\n    private readonly err?: EngineErrorHandler,\n    private readonly options: FetchRemoteApiOptions = {},\n  ) {}\n\n  async request<TResponse = unknown>(input: {\n    endpoint: string;\n    params?: Record<string, unknown>;\n    method?: 'GET' | 'POST';\n  }): Promise<TResponse> {\n    try {\n      const defaults = this.options.getDefaults?.() ?? readErpDefaults();\n      const token = this.options.getToken\n        ? (this.options.getToken() ?? '')\n        : readCookie('_auth');\n      const method = input.method ?? 'POST';\n      const url = joinUrl(this.options.baseUrl ?? '', input.endpoint);\n      const payload =\n        method === 'GET'\n          ? undefined\n          : {\n              ...(input.params ?? {}),\n              Defaults: {\n                CurrencyId: defaults.CurrencyId?.id,\n                CashierId: defaults.CashierId?.id,\n                PlaceId: defaults.PlaceId?.id,\n                YearId: defaults.YearId?.id,\n                LangId: defaults.LanguageId?.id,\n              },\n            };\n\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n      };\n      if (token) headers.Authorization = `Bearer ${token}`;\n\n      const res = await (this.options.fetcher ?? fetch)(url, {\n        method,\n        headers,\n        body: payload ? JSON.stringify(payload) : undefined,\n      });\n      if (!res.ok) {\n        // Never hand an error body to callers as if it were data.\n        throw new Error(\n          `RemoteApi request failed: HTTP ${res.status} ${input.endpoint}`,\n        );\n      }\n      try {\n        return (await res.json()) as TResponse;\n      } catch {\n        throw new Error(\n          `RemoteApi response is not valid JSON: HTTP ${res.status} ${input.endpoint}`,\n        );\n      }\n    } catch (error) {\n      this.err?.handle(error, 'FetchRemoteApi.request');\n      throw error;\n    }\n  }\n}\n"]}

package/dist/adapters/arian-erp.d.cts

@@ -0,0 +1,62 @@
+import { C as ConsoleAuditLogger, R as RemoteApi } from '../RemoteApi-CCQxiSf1.cjs';
+export { B as BaseQueryResult, C as CallbackRemoteApi, R as RemoteApiRequest, c as createBaseQueryRemoteApi } from '../callbackRemoteApi-Cv26MmSD.cjs';
+
+declare class EngineErrorHandler {
+    private readonly audit;
+    constructor(audit: ConsoleAuditLogger);
+    /**
+     * همه‌ی خطاها — چه DomainError چه runtime error — از اینجا رد می‌شن
+     * و از طریق ConsoleAuditLogger لاگ می‌شن.
+     */
+    handle(error: unknown, context?: string): void;
+    /** برای جاهایی که store یا table پیدا نشد */
+    notFound(entity: string, key: string, context?: string): void;
+}
+
+type ErpDefaults = {
+    PlaceId?: {
+        id?: number;
+    };
+    YearId?: {
+        id?: number;
+    };
+    LanguageId?: {
+        id?: number;
+    };
+    CashierId?: {
+        id?: number;
+    };
+    CurrencyId?: {
+        id?: number;
+    };
+};
+/**
+ * Host-injected RemoteApi for arianERP.
+ * Not the package default — pass `remoteApi={new FetchRemoteApi()}` from the ERP host.
+ * Reads auth cookie `_auth` and redux-persist `persist:arianERP`, then POSTs JSON
+ * (relative URLs work on the ERP host).
+ * Non-2xx responses and non-JSON bodies reject with an `Error` naming the HTTP
+ * status and endpoint (also reported through the optional error handler).
+ * See `examples/host-arian-erp/host-arian-erp.md`.
+ */
+type FetchRemoteApiOptions = {
+    baseUrl?: string;
+    /** Inject the bearer token (e.g. from the host's auth store). Default: cookie `_auth`. */
+    getToken?: () => string | undefined | null;
+    /** Inject ERP defaults (e.g. from Redux). Default: localStorage `persist:arianERP`. */
+    getDefaults?: () => ErpDefaults;
+    /** Custom fetch (tests, interceptors, token refresh). Default: global `fetch`. */
+    fetcher?: typeof fetch;
+};
+declare class FetchRemoteApi implements RemoteApi {
+    private readonly err?;
+    private readonly options;
+    constructor(err?: EngineErrorHandler | undefined, options?: FetchRemoteApiOptions);
+    request<TResponse = unknown>(input: {
+        endpoint: string;
+        params?: Record<string, unknown>;
+        method?: 'GET' | 'POST';
+    }): Promise<TResponse>;
+}
+
+export { type ErpDefaults, FetchRemoteApi, type FetchRemoteApiOptions };

package/dist/adapters/arian-erp.d.ts

@@ -0,0 +1,62 @@
+import { C as ConsoleAuditLogger, R as RemoteApi } from '../RemoteApi-CCQxiSf1.js';
+export { B as BaseQueryResult, C as CallbackRemoteApi, R as RemoteApiRequest, c as createBaseQueryRemoteApi } from '../callbackRemoteApi-BYLjmSI6.js';
+
+declare class EngineErrorHandler {
+    private readonly audit;
+    constructor(audit: ConsoleAuditLogger);
+    /**
+     * همه‌ی خطاها — چه DomainError چه runtime error — از اینجا رد می‌شن
+     * و از طریق ConsoleAuditLogger لاگ می‌شن.
+     */
+    handle(error: unknown, context?: string): void;
+    /** برای جاهایی که store یا table پیدا نشد */
+    notFound(entity: string, key: string, context?: string): void;
+}
+
+type ErpDefaults = {
+    PlaceId?: {
+        id?: number;
+    };
+    YearId?: {
+        id?: number;
+    };
+    LanguageId?: {
+        id?: number;
+    };
+    CashierId?: {
+        id?: number;
+    };
+    CurrencyId?: {
+        id?: number;
+    };
+};
+/**
+ * Host-injected RemoteApi for arianERP.
+ * Not the package default — pass `remoteApi={new FetchRemoteApi()}` from the ERP host.
+ * Reads auth cookie `_auth` and redux-persist `persist:arianERP`, then POSTs JSON
+ * (relative URLs work on the ERP host).
+ * Non-2xx responses and non-JSON bodies reject with an `Error` naming the HTTP
+ * status and endpoint (also reported through the optional error handler).
+ * See `examples/host-arian-erp/host-arian-erp.md`.
+ */
+type FetchRemoteApiOptions = {
+    baseUrl?: string;
+    /** Inject the bearer token (e.g. from the host's auth store). Default: cookie `_auth`. */
+    getToken?: () => string | undefined | null;
+    /** Inject ERP defaults (e.g. from Redux). Default: localStorage `persist:arianERP`. */
+    getDefaults?: () => ErpDefaults;
+    /** Custom fetch (tests, interceptors, token refresh). Default: global `fetch`. */
+    fetcher?: typeof fetch;
+};
+declare class FetchRemoteApi implements RemoteApi {
+    private readonly err?;
+    private readonly options;
+    constructor(err?: EngineErrorHandler | undefined, options?: FetchRemoteApiOptions);
+    request<TResponse = unknown>(input: {
+        endpoint: string;
+        params?: Record<string, unknown>;
+        method?: 'GET' | 'POST';
+    }): Promise<TResponse>;
+}
+
+export { type ErpDefaults, FetchRemoteApi, type FetchRemoteApiOptions };

package/dist/adapters/arian-erp.js

@@ -0,0 +1,79 @@
+export { CallbackRemoteApi, createBaseQueryRemoteApi } from '../chunk-SVO62ZV2.js';
+
+// infrastructure/Repositories/fetchRemoteApi.ts
+function readCookie(name) {
+  if (typeof document === "undefined") return "";
+  const cookies = document.cookie.split(";");
+  const cookie = cookies.find((item) => item.trim().startsWith(`${name}=`));
+  if (!cookie) return "";
+  return cookie.trim().slice(name.length + 1);
+}
+function readErpDefaults() {
+  if (typeof window === "undefined") return {};
+  try {
+    const storage = localStorage.getItem("persist:arianERP");
+    const parsedStorage = JSON.parse(storage ?? "{}");
+    const parsedConfig = JSON.parse(parsedStorage.config ?? "{}");
+    return parsedConfig.defaultConfigs ?? {};
+  } catch {
+    return {};
+  }
+}
+function joinUrl(baseUrl, endpoint) {
+  if (/^https?:\/\//i.test(endpoint)) return endpoint;
+  const base = baseUrl.replace(/\/$/, "");
+  const path = endpoint.startsWith("/") ? endpoint : `/${endpoint}`;
+  return `${base}${path}`;
+}
+var FetchRemoteApi = class {
+  constructor(err, options = {}) {
+    this.err = err;
+    this.options = options;
+  }
+  async request(input) {
+    try {
+      const defaults = this.options.getDefaults?.() ?? readErpDefaults();
+      const token = this.options.getToken ? this.options.getToken() ?? "" : readCookie("_auth");
+      const method = input.method ?? "POST";
+      const url = joinUrl(this.options.baseUrl ?? "", input.endpoint);
+      const payload = method === "GET" ? void 0 : {
+        ...input.params ?? {},
+        Defaults: {
+          CurrencyId: defaults.CurrencyId?.id,
+          CashierId: defaults.CashierId?.id,
+          PlaceId: defaults.PlaceId?.id,
+          YearId: defaults.YearId?.id,
+          LangId: defaults.LanguageId?.id
+        }
+      };
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (token) headers.Authorization = `Bearer ${token}`;
+      const res = await (this.options.fetcher ?? fetch)(url, {
+        method,
+        headers,
+        body: payload ? JSON.stringify(payload) : void 0
+      });
+      if (!res.ok) {
+        throw new Error(
+          `RemoteApi request failed: HTTP ${res.status} ${input.endpoint}`
+        );
+      }
+      try {
+        return await res.json();
+      } catch {
+        throw new Error(
+          `RemoteApi response is not valid JSON: HTTP ${res.status} ${input.endpoint}`
+        );
+      }
+    } catch (error) {
+      this.err?.handle(error, "FetchRemoteApi.request");
+      throw error;
+    }
+  }
+};
+
+export { FetchRemoteApi };
+//# sourceMappingURL=arian-erp.js.map
+//# sourceMappingURL=arian-erp.js.map

package/dist/adapters/arian-erp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../infrastructure/Repositories/fetchRemoteApi.ts"],"names":[],"mappings":"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","file":"arian-erp.js","sourcesContent":["import { EngineErrorHandler } from '../../engine/EngineErrorHandler';\nimport { RemoteApi } from '../../application/ports/RemoteApi';\n\nexport type ErpDefaults = {\n  PlaceId?: { id?: number };\n  YearId?: { id?: number };\n  LanguageId?: { id?: number };\n  CashierId?: { id?: number };\n  CurrencyId?: { id?: number };\n};\n\nfunction readCookie(name: string): string {\n  if (typeof document === 'undefined') return '';\n  const cookies = document.cookie.split(';');\n  const cookie = cookies.find((item) => item.trim().startsWith(`${name}=`));\n  if (!cookie) return '';\n  return cookie.trim().slice(name.length + 1);\n}\n\nfunction readErpDefaults(): ErpDefaults {\n  if (typeof window === 'undefined') return {};\n  try {\n    const storage = localStorage.getItem('persist:arianERP');\n    const parsedStorage = JSON.parse(storage ?? '{}');\n    const parsedConfig = JSON.parse(parsedStorage.config ?? '{}');\n    return parsedConfig.defaultConfigs ?? {};\n  } catch {\n    return {};\n  }\n}\n\nfunction joinUrl(baseUrl: string, endpoint: string): string {\n  if (/^https?:\\/\\//i.test(endpoint)) return endpoint;\n  const base = baseUrl.replace(/\\/$/, '');\n  const path = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;\n  return `${base}${path}`;\n}\n\n/**\n * Host-injected RemoteApi for arianERP.\n * Not the package default — pass `remoteApi={new FetchRemoteApi()}` from the ERP host.\n * Reads auth cookie `_auth` and redux-persist `persist:arianERP`, then POSTs JSON\n * (relative URLs work on the ERP host).\n * Non-2xx responses and non-JSON bodies reject with an `Error` naming the HTTP\n * status and endpoint (also reported through the optional error handler).\n * See `examples/host-arian-erp/host-arian-erp.md`.\n */\nexport type FetchRemoteApiOptions = {\n  baseUrl?: string;\n  /** Inject the bearer token (e.g. from the host's auth store). Default: cookie `_auth`. */\n  getToken?: () => string | undefined | null;\n  /** Inject ERP defaults (e.g. from Redux). Default: localStorage `persist:arianERP`. */\n  getDefaults?: () => ErpDefaults;\n  /** Custom fetch (tests, interceptors, token refresh). Default: global `fetch`. */\n  fetcher?: typeof fetch;\n};\n\nexport class FetchRemoteApi implements RemoteApi {\n  constructor(\n    private readonly err?: EngineErrorHandler,\n    private readonly options: FetchRemoteApiOptions = {},\n  ) {}\n\n  async request<TResponse = unknown>(input: {\n    endpoint: string;\n    params?: Record<string, unknown>;\n    method?: 'GET' | 'POST';\n  }): Promise<TResponse> {\n    try {\n      const defaults = this.options.getDefaults?.() ?? readErpDefaults();\n      const token = this.options.getToken\n        ? (this.options.getToken() ?? '')\n        : readCookie('_auth');\n      const method = input.method ?? 'POST';\n      const url = joinUrl(this.options.baseUrl ?? '', input.endpoint);\n      const payload =\n        method === 'GET'\n          ? undefined\n          : {\n              ...(input.params ?? {}),\n              Defaults: {\n                CurrencyId: defaults.CurrencyId?.id,\n                CashierId: defaults.CashierId?.id,\n                PlaceId: defaults.PlaceId?.id,\n                YearId: defaults.YearId?.id,\n                LangId: defaults.LanguageId?.id,\n              },\n            };\n\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n      };\n      if (token) headers.Authorization = `Bearer ${token}`;\n\n      const res = await (this.options.fetcher ?? fetch)(url, {\n        method,\n        headers,\n        body: payload ? JSON.stringify(payload) : undefined,\n      });\n      if (!res.ok) {\n        // Never hand an error body to callers as if it were data.\n        throw new Error(\n          `RemoteApi request failed: HTTP ${res.status} ${input.endpoint}`,\n        );\n      }\n      try {\n        return (await res.json()) as TResponse;\n      } catch {\n        throw new Error(\n          `RemoteApi response is not valid JSON: HTTP ${res.status} ${input.endpoint}`,\n        );\n      }\n    } catch (error) {\n      this.err?.handle(error, 'FetchRemoteApi.request');\n      throw error;\n    }\n  }\n}\n"]}

package/dist/appendAtEnd-RHIQRG2W.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+var chunkNTV2UUAJ_cjs = require('./chunk-NTV2UUAJ.cjs');
+
+// application/handlers/appendAtEnd.ts
+async function appendAtEndAndShowLastPage(repo, store, tableKey, table, data) {
+  let maxIndex = 0;
+  let existingCount = 0;
+  await repo.iterateRowRecords(store, tableKey, "active", async (records) => {
+    for (const rec of records) {
+      existingCount += 1;
+      const n = Number(rec.cells["index"]?.value ?? 0);
+      if (Number.isFinite(n) && n > maxIndex) maxIndex = n;
+    }
+  });
+  const nextIndex = maxIndex + 1;
+  const newTotal = Math.max(table.getPagination().totalRows, existingCount) + 1;
+  const pageSize = Math.max(1, table.getPagination().pageSize);
+  const lastPage = Math.max(1, Math.ceil(newTotal / pageSize));
+  const event = table.addNewRow(data, nextIndex);
+  table.setPagination(new chunkNTV2UUAJ_cjs.Pagination(lastPage, pageSize, newTotal));
+  await repo.save(store, table);
+  const loaded = await repo.loadPage(store, tableKey, lastPage, pageSize);
+  if (loaded) {
+    if (loaded.getPagination().totalRows !== newTotal || loaded.getPagination().page !== lastPage) {
+      loaded.setPagination(new chunkNTV2UUAJ_cjs.Pagination(lastPage, pageSize, newTotal));
+      await repo.save(store, loaded);
+    }
+  }
+  return event;
+}
+
+exports.appendAtEndAndShowLastPage = appendAtEndAndShowLastPage;
+//# sourceMappingURL=appendAtEnd-RHIQRG2W.cjs.map
+//# sourceMappingURL=appendAtEnd-RHIQRG2W.cjs.map

package/dist/appendAtEnd-RHIQRG2W.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../application/handlers/appendAtEnd.ts"],"names":["Pagination"],"mappings":";;;;;AAcA,eAAsB,0BAAA,CACpB,IAAA,EACA,KAAA,EACA,QAAA,EACA,OACA,IAAA,EACmB;AACnB,EAAA,IAAI,QAAA,GAAW,CAAA;AACf,EAAA,IAAI,aAAA,GAAgB,CAAA;AACpB,EAAA,MAAM,KAAK,iBAAA,CAAkB,KAAA,EAAO,QAAA,EAAU,QAAA,EAAU,OAAM,OAAA,KAAW;AACvE,IAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,MAAA,aAAA,IAAiB,CAAA;AAGjB,MAAA,MAAM,IAAI,MAAA,CAAO,GAAA,CAAI,MAAM,OAAO,CAAA,EAAG,SAAS,CAAC,CAAA;AAC/C,MAAA,IAAI,OAAO,QAAA,CAAS,CAAC,CAAA,IAAK,CAAA,GAAI,UAAU,QAAA,GAAW,CAAA;AAAA,IACrD;AAAA,EACF,CAAC,CAAA;AACD,EAAA,MAAM,YAAY,QAAA,GAAW,CAAA;AAG7B,EAAA,MAAM,QAAA,GAAW,KAAK,GAAA,CAAI,KAAA,CAAM,eAAc,CAAE,SAAA,EAAW,aAAa,CAAA,GAAI,CAAA;AAC5E,EAAA,MAAM,WAAW,IAAA,CAAK,GAAA,CAAI,GAAG,KAAA,CAAM,aAAA,GAAgB,QAAQ,CAAA;AAC3D,EAAA,MAAM,QAAA,GAAW,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,IAAA,CAAK,QAAA,GAAW,QAAQ,CAAC,CAAA;AAE3D,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,SAAA,CAAU,IAAA,EAAM,SAAS,CAAA;AAE7C,EAAA,KAAA,CAAM,cAAc,IAAIA,4BAAA,CAAW,QAAA,EAAU,QAAA,EAAU,QAAQ,CAAC,CAAA;AAEhE,EAAA,MAAM,IAAA,CAAK,IAAA,CAAK,KAAA,EAAO,KAAK,CAAA;AAE5B,EAAA,MAAM,SAAS,MAAM,IAAA,CAAK,SAAS,KAAA,EAAO,QAAA,EAAU,UAAU,QAAQ,CAAA;AACtE,EAAA,IAAI,MAAA,EAAQ;AAEV,IAAA,IACE,MAAA,CAAO,eAAc,CAAE,SAAA,KAAc,YACrC,MAAA,CAAO,aAAA,EAAc,CAAE,IAAA,KAAS,QAAA,EAChC;AACA,MAAA,MAAA,CAAO,cAAc,IAAIA,4BAAA,CAAW,QAAA,EAAU,QAAA,EAAU,QAAQ,CAAC,CAAA;AACjE,MAAA,MAAM,IAAA,CAAK,IAAA,CAAK,KAAA,EAAO,MAAM,CAAA;AAAA,IAC/B;AAAA,EACF;AAEA,EAAA,OAAO,KAAA;AACT","file":"appendAtEnd-RHIQRG2W.cjs","sourcesContent":["// application/handlers/appendAtEnd.ts — page-window ('paged-idb') helper.\r\nimport { RowAdded } from '../../domain/events';\r\nimport { Table } from '../../domain/entities/Table';\r\nimport { KeyValue, Pagination } from '../../domain/value-objects';\r\nimport { WindowedTableRepository } from '../ports/TableRepository';\r\n\r\n/**\r\n * Append a row at the end of the full dataset (IndexedDB SoT), bump totalRows,\r\n * then load the last page into the RAM window so UI/pagination stay correct.\r\n *\r\n * Memory Iron Rule: max index + row count are computed with ONE streaming\r\n * cursor pass over IndexedDB (batch-bounded heap) — never a full getAllRows\r\n * hydration of the dataset.\r\n */\r\nexport async function appendAtEndAndShowLastPage(\r\n  repo: WindowedTableRepository,\r\n  store: string,\r\n  tableKey: string,\r\n  table: Table,\r\n  data?: KeyValue[],\r\n): Promise<RowAdded> {\r\n  let maxIndex = 0;\r\n  let existingCount = 0;\r\n  await repo.iterateRowRecords(store, tableKey, 'active', async records => {\r\n    for (const rec of records) {\r\n      existingCount += 1;\r\n      // Same semantics as the former getAllRows reduce: cell 'index' value,\r\n      // 0 when missing/non-numeric.\r\n      const n = Number(rec.cells['index']?.value ?? 0);\r\n      if (Number.isFinite(n) && n > maxIndex) maxIndex = n;\r\n    }\r\n  });\r\n  const nextIndex = maxIndex + 1;\r\n\r\n  // Meta may be stale (stuck at pageSize); trust the larger of meta vs real count\r\n  const newTotal = Math.max(table.getPagination().totalRows, existingCount) + 1;\r\n  const pageSize = Math.max(1, table.getPagination().pageSize);\r\n  const lastPage = Math.max(1, Math.ceil(newTotal / pageSize));\r\n\r\n  const event = table.addNewRow(data, nextIndex);\r\n  // Force correct totals/page (addNewRow may have used a stale base totalRows)\r\n  table.setPagination(new Pagination(lastPage, pageSize, newTotal));\r\n\r\n  await repo.save(store, table);\r\n\r\n  const loaded = await repo.loadPage(store, tableKey, lastPage, pageSize);\r\n  if (loaded) {\r\n    // Ensure RAM window carries the corrected pagination after load\r\n    if (\r\n      loaded.getPagination().totalRows !== newTotal ||\r\n      loaded.getPagination().page !== lastPage\r\n    ) {\r\n      loaded.setPagination(new Pagination(lastPage, pageSize, newTotal));\r\n      await repo.save(store, loaded);\r\n    }\r\n  }\r\n\r\n  return event;\r\n}\r\n"]}

package/dist/appendAtEnd-TJEABLGD.js

@@ -0,0 +1,33 @@
+import { Pagination } from './chunk-XLRE2J25.js';
+
+// application/handlers/appendAtEnd.ts
+async function appendAtEndAndShowLastPage(repo, store, tableKey, table, data) {
+  let maxIndex = 0;
+  let existingCount = 0;
+  await repo.iterateRowRecords(store, tableKey, "active", async (records) => {
+    for (const rec of records) {
+      existingCount += 1;
+      const n = Number(rec.cells["index"]?.value ?? 0);
+      if (Number.isFinite(n) && n > maxIndex) maxIndex = n;
+    }
+  });
+  const nextIndex = maxIndex + 1;
+  const newTotal = Math.max(table.getPagination().totalRows, existingCount) + 1;
+  const pageSize = Math.max(1, table.getPagination().pageSize);
+  const lastPage = Math.max(1, Math.ceil(newTotal / pageSize));
+  const event = table.addNewRow(data, nextIndex);
+  table.setPagination(new Pagination(lastPage, pageSize, newTotal));
+  await repo.save(store, table);
+  const loaded = await repo.loadPage(store, tableKey, lastPage, pageSize);
+  if (loaded) {
+    if (loaded.getPagination().totalRows !== newTotal || loaded.getPagination().page !== lastPage) {
+      loaded.setPagination(new Pagination(lastPage, pageSize, newTotal));
+      await repo.save(store, loaded);
+    }
+  }
+  return event;
+}
+
+export { appendAtEndAndShowLastPage };
+//# sourceMappingURL=appendAtEnd-TJEABLGD.js.map
+//# sourceMappingURL=appendAtEnd-TJEABLGD.js.map

package/dist/appendAtEnd-TJEABLGD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../application/handlers/appendAtEnd.ts"],"names":[],"mappings":";;;AAcA,eAAsB,0BAAA,CACpB,IAAA,EACA,KAAA,EACA,QAAA,EACA,OACA,IAAA,EACmB;AACnB,EAAA,IAAI,QAAA,GAAW,CAAA;AACf,EAAA,IAAI,aAAA,GAAgB,CAAA;AACpB,EAAA,MAAM,KAAK,iBAAA,CAAkB,KAAA,EAAO,QAAA,EAAU,QAAA,EAAU,OAAM,OAAA,KAAW;AACvE,IAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,MAAA,aAAA,IAAiB,CAAA;AAGjB,MAAA,MAAM,IAAI,MAAA,CAAO,GAAA,CAAI,MAAM,OAAO,CAAA,EAAG,SAAS,CAAC,CAAA;AAC/C,MAAA,IAAI,OAAO,QAAA,CAAS,CAAC,CAAA,IAAK,CAAA,GAAI,UAAU,QAAA,GAAW,CAAA;AAAA,IACrD;AAAA,EACF,CAAC,CAAA;AACD,EAAA,MAAM,YAAY,QAAA,GAAW,CAAA;AAG7B,EAAA,MAAM,QAAA,GAAW,KAAK,GAAA,CAAI,KAAA,CAAM,eAAc,CAAE,SAAA,EAAW,aAAa,CAAA,GAAI,CAAA;AAC5E,EAAA,MAAM,WAAW,IAAA,CAAK,GAAA,CAAI,GAAG,KAAA,CAAM,aAAA,GAAgB,QAAQ,CAAA;AAC3D,EAAA,MAAM,QAAA,GAAW,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,IAAA,CAAK,QAAA,GAAW,QAAQ,CAAC,CAAA;AAE3D,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,SAAA,CAAU,IAAA,EAAM,SAAS,CAAA;AAE7C,EAAA,KAAA,CAAM,cAAc,IAAI,UAAA,CAAW,QAAA,EAAU,QAAA,EAAU,QAAQ,CAAC,CAAA;AAEhE,EAAA,MAAM,IAAA,CAAK,IAAA,CAAK,KAAA,EAAO,KAAK,CAAA;AAE5B,EAAA,MAAM,SAAS,MAAM,IAAA,CAAK,SAAS,KAAA,EAAO,QAAA,EAAU,UAAU,QAAQ,CAAA;AACtE,EAAA,IAAI,MAAA,EAAQ;AAEV,IAAA,IACE,MAAA,CAAO,eAAc,CAAE,SAAA,KAAc,YACrC,MAAA,CAAO,aAAA,EAAc,CAAE,IAAA,KAAS,QAAA,EAChC;AACA,MAAA,MAAA,CAAO,cAAc,IAAI,UAAA,CAAW,QAAA,EAAU,QAAA,EAAU,QAAQ,CAAC,CAAA;AACjE,MAAA,MAAM,IAAA,CAAK,IAAA,CAAK,KAAA,EAAO,MAAM,CAAA;AAAA,IAC/B;AAAA,EACF;AAEA,EAAA,OAAO,KAAA;AACT","file":"appendAtEnd-TJEABLGD.js","sourcesContent":["// application/handlers/appendAtEnd.ts — page-window ('paged-idb') helper.\r\nimport { RowAdded } from '../../domain/events';\r\nimport { Table } from '../../domain/entities/Table';\r\nimport { KeyValue, Pagination } from '../../domain/value-objects';\r\nimport { WindowedTableRepository } from '../ports/TableRepository';\r\n\r\n/**\r\n * Append a row at the end of the full dataset (IndexedDB SoT), bump totalRows,\r\n * then load the last page into the RAM window so UI/pagination stay correct.\r\n *\r\n * Memory Iron Rule: max index + row count are computed with ONE streaming\r\n * cursor pass over IndexedDB (batch-bounded heap) — never a full getAllRows\r\n * hydration of the dataset.\r\n */\r\nexport async function appendAtEndAndShowLastPage(\r\n  repo: WindowedTableRepository,\r\n  store: string,\r\n  tableKey: string,\r\n  table: Table,\r\n  data?: KeyValue[],\r\n): Promise<RowAdded> {\r\n  let maxIndex = 0;\r\n  let existingCount = 0;\r\n  await repo.iterateRowRecords(store, tableKey, 'active', async records => {\r\n    for (const rec of records) {\r\n      existingCount += 1;\r\n      // Same semantics as the former getAllRows reduce: cell 'index' value,\r\n      // 0 when missing/non-numeric.\r\n      const n = Number(rec.cells['index']?.value ?? 0);\r\n      if (Number.isFinite(n) && n > maxIndex) maxIndex = n;\r\n    }\r\n  });\r\n  const nextIndex = maxIndex + 1;\r\n\r\n  // Meta may be stale (stuck at pageSize); trust the larger of meta vs real count\r\n  const newTotal = Math.max(table.getPagination().totalRows, existingCount) + 1;\r\n  const pageSize = Math.max(1, table.getPagination().pageSize);\r\n  const lastPage = Math.max(1, Math.ceil(newTotal / pageSize));\r\n\r\n  const event = table.addNewRow(data, nextIndex);\r\n  // Force correct totals/page (addNewRow may have used a stale base totalRows)\r\n  table.setPagination(new Pagination(lastPage, pageSize, newTotal));\r\n\r\n  await repo.save(store, table);\r\n\r\n  const loaded = await repo.loadPage(store, tableKey, lastPage, pageSize);\r\n  if (loaded) {\r\n    // Ensure RAM window carries the corrected pagination after load\r\n    if (\r\n      loaded.getPagination().totalRows !== newTotal ||\r\n      loaded.getPagination().page !== lastPage\r\n    ) {\r\n      loaded.setPagination(new Pagination(lastPage, pageSize, newTotal));\r\n      await repo.save(store, loaded);\r\n    }\r\n  }\r\n\r\n  return event;\r\n}\r\n"]}