@jsdev_ninja/core 0.15.2 → 0.16.0

package/dist/lib/entities/Order.d.ts

@@ -1860,6 +1860,26 @@ export declare const OrderSchema: z.ZodObject<{
     emailOnInvoice: z.ZodOptional<z.ZodString>;
     phoneNumberOnInvoice: z.ZodOptional<z.ZodString>;
     clientComment: z.ZodOptional<z.ZodString>;
+    companyName: z.ZodOptional<z.ZodString>;
+    companyNumber: z.ZodOptional<z.ZodString>;
+    contact: z.ZodOptional<z.ZodObject<{
+        fullName: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        email?: string | undefined;
+        phone?: string | undefined;
+        fullName?: string | undefined;
+        role?: string | undefined;
+    }, {
+        email?: string | undefined;
+        phone?: string | undefined;
+        fullName?: string | undefined;
+        role?: string | undefined;
+    }>>;
+    poNumber: z.ZodOptional<z.ZodString>;
+    outOfStockPolicy: z.ZodOptional<z.ZodEnum<["substitute", "remove"]>>;
     organizationId: z.ZodOptional<z.ZodString>;
     billingAccount: z.ZodOptional<z.ZodObject<{
         number: z.ZodString;
@@ -2498,6 +2518,7 @@ export declare const OrderSchema: z.ZodObject<{
         deliveryPrice?: number | undefined;
     };
     deliveryDate: number;
+    companyName?: string | undefined;
     address?: {
         country?: string | undefined;
         city?: string | undefined;
@@ -2510,6 +2531,7 @@ export declare const OrderSchema: z.ZodObject<{
     paymentType?: "none" | "external" | "j5" | undefined;
     organizationId?: string | undefined;
     nameOnInvoice?: string | undefined;
+    companyNumber?: string | undefined;
     createdBy?: "user" | "admin" | undefined;
     storeOptions?: {
         deliveryPrice?: number | undefined;
@@ -2548,6 +2570,14 @@ export declare const OrderSchema: z.ZodObject<{
     emailOnInvoice?: string | undefined;
     phoneNumberOnInvoice?: string | undefined;
     clientComment?: string | undefined;
+    contact?: {
+        email?: string | undefined;
+        phone?: string | undefined;
+        fullName?: string | undefined;
+        role?: string | undefined;
+    } | undefined;
+    poNumber?: string | undefined;
+    outOfStockPolicy?: "substitute" | "remove" | undefined;
     billingAccount?: {
         number: string;
         id: string;
@@ -2869,6 +2899,7 @@ export declare const OrderSchema: z.ZodObject<{
         deliveryPrice?: number | undefined;
     };
     deliveryDate: number;
+    companyName?: string | undefined;
     address?: {
         country?: string | undefined;
         city?: string | undefined;
@@ -2881,6 +2912,7 @@ export declare const OrderSchema: z.ZodObject<{
     paymentType?: "none" | "external" | "j5" | undefined;
     organizationId?: string | undefined;
     nameOnInvoice?: string | undefined;
+    companyNumber?: string | undefined;
     createdBy?: "user" | "admin" | undefined;
     storeOptions?: {
         deliveryPrice?: number | undefined;
@@ -2919,6 +2951,14 @@ export declare const OrderSchema: z.ZodObject<{
     emailOnInvoice?: string | undefined;
     phoneNumberOnInvoice?: string | undefined;
     clientComment?: string | undefined;
+    contact?: {
+        email?: string | undefined;
+        phone?: string | undefined;
+        fullName?: string | undefined;
+        role?: string | undefined;
+    } | undefined;
+    poNumber?: string | undefined;
+    outOfStockPolicy?: "substitute" | "remove" | undefined;
     billingAccount?: {
         number: string;
         id: string;

package/dist/lib/entities/Order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Order.d.ts","sourceRoot":"","sources":["../../../lib/entities/Order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDtB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"Order.d.ts","sourceRoot":"","sources":["../../../lib/entities/Order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkEtB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/lib/entities/Order.js

@@ -57,6 +57,19 @@ export const OrderSchema = z.object({
     emailOnInvoice: z.string().email().optional(),
     phoneNumberOnInvoice: z.string().optional(),
     clientComment: z.string().optional(),
+    // --- B2B buyer details (optional, additive — back-compat) ---
+    companyName: z.string().optional(),
+    companyNumber: z.string().optional(), // ח.פ / עוסק מורשה (aligns with Organization.companyNumber)
+    contact: z
+        .object({
+        fullName: z.string().optional(),
+        role: z.string().optional(), // תפקיד
+        phone: z.string().optional(),
+        email: z.string().optional(),
+    })
+        .optional(),
+    poNumber: z.string().optional(), // הזמנת רכש
+    outOfStockPolicy: z.enum(["substitute", "remove"]).optional(),
     organizationId: z.string().optional(),
     billingAccount: BillingAccountSchema.optional(),
     deliveryNote: DeliveryNoteSchema.optional(),

package/dist/lib/entities/OrganizationBalance.d.ts

@@ -0,0 +1,138 @@
+import { z } from "zod";
+export declare const OrganizationBalanceEntrySchema: z.ZodObject<{
+    /** = deterministic dedup doc id */
+    id: z.ZodString;
+    organizationId: z.ZodString;
+    /** "+" increases owed (accrual), "-" decreases owed (settlement/adjustment) */
+    sign: z.ZodEnum<["+", "-"]>;
+    kind: z.ZodEnum<["accrual", "settlement", "adjustment"]>;
+    /** Integer agorot, always positive; sign carries direction */
+    amount: z.ZodNumber;
+    currency: z.ZodLiteral<"ILS">;
+    source: z.ZodEnum<["delivery_note", "ledger_payment", "manual", "order_reversal"]>;
+    /** Present for document-sourced accruals */
+    document: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["delivery_note", "invoice"]>;
+        id: z.ZodString;
+        number: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "invoice" | "delivery_note";
+        id: string;
+        number?: string | undefined;
+    }, {
+        type: "invoice" | "delivery_note";
+        id: string;
+        number?: string | undefined;
+    }>>;
+    /** Order id (accrual), ledger txId (settlement), or manual ref */
+    reference: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["order", "transaction", "manual"]>;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "order" | "manual" | "transaction";
+        id: string;
+    }, {
+        type: "order" | "manual" | "transaction";
+        id: string;
+    }>>;
+    /** Optional sub-grouping within an org */
+    billingAccountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Deterministic dedup key; doc id is derived from this */
+    dedupKey: z.ZodString;
+    /** Event id when source is event-driven */
+    causedByEventId: z.ZodOptional<z.ZodString>;
+    /** Epoch millis — used for date-range queries */
+    createdAt: z.ZodNumber;
+    companyId: z.ZodString;
+    storeId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    companyId: string;
+    storeId: string;
+    currency: "ILS";
+    amount: number;
+    organizationId: string;
+    createdAt: number;
+    source: "manual" | "delivery_note" | "ledger_payment" | "order_reversal";
+    sign: "+" | "-";
+    kind: "accrual" | "settlement" | "adjustment";
+    dedupKey: string;
+    billingAccountId?: string | null | undefined;
+    causedByEventId?: string | undefined;
+    document?: {
+        type: "invoice" | "delivery_note";
+        id: string;
+        number?: string | undefined;
+    } | undefined;
+    reference?: {
+        type: "order" | "manual" | "transaction";
+        id: string;
+    } | undefined;
+}, {
+    id: string;
+    companyId: string;
+    storeId: string;
+    currency: "ILS";
+    amount: number;
+    organizationId: string;
+    createdAt: number;
+    source: "manual" | "delivery_note" | "ledger_payment" | "order_reversal";
+    sign: "+" | "-";
+    kind: "accrual" | "settlement" | "adjustment";
+    dedupKey: string;
+    billingAccountId?: string | null | undefined;
+    causedByEventId?: string | undefined;
+    document?: {
+        type: "invoice" | "delivery_note";
+        id: string;
+        number?: string | undefined;
+    } | undefined;
+    reference?: {
+        type: "order" | "manual" | "transaction";
+        id: string;
+    } | undefined;
+}>;
+export type TOrganizationBalanceEntry = z.infer<typeof OrganizationBalanceEntrySchema>;
+export declare const OrganizationBalanceRollupSchema: z.ZodObject<{
+    /** = doc id */
+    organizationId: z.ZodString;
+    /** Σ(+) − Σ(−), clamped ≥ 0; integer agorot. Non-zero only when totalAccrued > totalSettled. */
+    owed: z.ZodNumber;
+    /**
+     * Overpayment credit: max(0, totalSettled − totalAccrued); integer agorot, ≥ 0.
+     * Non-zero only when org has paid MORE than it has accrued.
+     * Visibility only — not client-spendable. At most one of {owed, credit} is non-zero.
+     */
+    credit: z.ZodNumber;
+    /** Lifetime Σ(+); integer agorot */
+    totalAccrued: z.ZodNumber;
+    /** Lifetime Σ(−); integer agorot */
+    totalSettled: z.ZodNumber;
+    currency: z.ZodLiteral<"ILS">;
+    /** Epoch millis */
+    updatedAt: z.ZodNumber;
+    companyId: z.ZodString;
+    storeId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    companyId: string;
+    storeId: string;
+    currency: "ILS";
+    organizationId: string;
+    updatedAt: number;
+    owed: number;
+    credit: number;
+    totalAccrued: number;
+    totalSettled: number;
+}, {
+    companyId: string;
+    storeId: string;
+    currency: "ILS";
+    organizationId: string;
+    updatedAt: number;
+    owed: number;
+    credit: number;
+    totalAccrued: number;
+    totalSettled: number;
+}>;
+export type TOrganizationBalanceRollup = z.infer<typeof OrganizationBalanceRollupSchema>;
+//# sourceMappingURL=OrganizationBalance.d.ts.map

package/dist/lib/entities/OrganizationBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationBalance.d.ts","sourceRoot":"","sources":["../../../lib/entities/OrganizationBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,8BAA8B;IAC1C,mCAAmC;;;IAGnC,+EAA+E;;;IAG/E,8DAA8D;;;;IAI9D,4CAA4C;;;;;;;;;;;;;;IAQ5C,kEAAkE;;;;;;;;;;;IAOlE,0CAA0C;;IAE1C,2DAA2D;;IAE3D,2CAA2C;;IAE3C,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIhD,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAMvF,eAAO,MAAM,+BAA+B;IAC3C,eAAe;;IAEf,gGAAgG;;IAEhG;;;;OAIG;;IAEH,oCAAoC;;IAEpC,oCAAoC;;;IAGpC,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAIlB,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/lib/entities/OrganizationBalance.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Append-only AR entry ledger document
+// ---------------------------------------------------------------------------
+export const OrganizationBalanceEntrySchema = z.object({
+    /** = deterministic dedup doc id */
+    id: z.string().min(1),
+    organizationId: z.string().min(1),
+    /** "+" increases owed (accrual), "-" decreases owed (settlement/adjustment) */
+    sign: z.enum(["+", "-"]),
+    kind: z.enum(["accrual", "settlement", "adjustment"]),
+    /** Integer agorot, always positive; sign carries direction */
+    amount: z.number().int().positive(),
+    currency: z.literal("ILS"),
+    source: z.enum(["delivery_note", "ledger_payment", "manual", "order_reversal"]),
+    /** Present for document-sourced accruals */
+    document: z
+        .object({
+        type: z.enum(["delivery_note", "invoice"]),
+        id: z.string().min(1),
+        number: z.string().optional(),
+    })
+        .optional(),
+    /** Order id (accrual), ledger txId (settlement), or manual ref */
+    reference: z
+        .object({
+        type: z.enum(["order", "transaction", "manual"]),
+        id: z.string().min(1),
+    })
+        .optional(),
+    /** Optional sub-grouping within an org */
+    billingAccountId: z.string().nullable().optional(),
+    /** Deterministic dedup key; doc id is derived from this */
+    dedupKey: z.string().min(1),
+    /** Event id when source is event-driven */
+    causedByEventId: z.string().optional(),
+    /** Epoch millis — used for date-range queries */
+    createdAt: z.number().int().positive(),
+    companyId: z.string().min(1),
+    storeId: z.string().min(1),
+});
+// ---------------------------------------------------------------------------
+// Per-org rollup cache (O(1) balance reads)
+// ---------------------------------------------------------------------------
+export const OrganizationBalanceRollupSchema = z.object({
+    /** = doc id */
+    organizationId: z.string().min(1),
+    /** Σ(+) − Σ(−), clamped ≥ 0; integer agorot. Non-zero only when totalAccrued > totalSettled. */
+    owed: z.number().int(),
+    /**
+     * Overpayment credit: max(0, totalSettled − totalAccrued); integer agorot, ≥ 0.
+     * Non-zero only when org has paid MORE than it has accrued.
+     * Visibility only — not client-spendable. At most one of {owed, credit} is non-zero.
+     */
+    credit: z.number().int(),
+    /** Lifetime Σ(+); integer agorot */
+    totalAccrued: z.number().int(),
+    /** Lifetime Σ(−); integer agorot */
+    totalSettled: z.number().int(),
+    currency: z.literal("ILS"),
+    /** Epoch millis */
+    updatedAt: z.number().int().positive(),
+    companyId: z.string().min(1),
+    storeId: z.string().min(1),
+});

package/dist/lib/entities/index.d.ts

@@ -17,4 +17,5 @@ export * from "./Payment";
 export * from "./Supplier";
 export * from "./SupplierInvoice";
 export * from "./Budget";
+export * from "./OrganizationBalance";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/entities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC"}

package/dist/lib/entities/index.js

@@ -17,3 +17,4 @@ export * from "./Payment";
 export * from "./Supplier";
 export * from "./SupplierInvoice";
 export * from "./Budget";
+export * from "./OrganizationBalance";

package/dist/lib/firebase-api/index.d.ts

@@ -28,6 +28,8 @@ export declare const storeCollections: {
     readonly transactions: "transactions";
     readonly paymentLinks: "paymentLinks";
     readonly duplicateChargeAlerts: "duplicateChargeAlerts";
+    readonly organizationBalance: "organizationBalance";
+    readonly organizationBalanceRollup: "organizationBalanceRollup";
 };
 export declare const FirestoreApi: {
     systemCollections: {
@@ -60,6 +62,8 @@ export declare const FirestoreApi: {
         readonly transactions: "transactions";
         readonly paymentLinks: "paymentLinks";
         readonly duplicateChargeAlerts: "duplicateChargeAlerts";
+        readonly organizationBalance: "organizationBalance";
+        readonly organizationBalanceRollup: "organizationBalanceRollup";
     };
     getPath: ({ companyId, storeId, collectionName, id, }: {
         companyId: string;
@@ -110,6 +114,8 @@ export declare const FirebaseAPI: {
             readonly transactions: "transactions";
             readonly paymentLinks: "paymentLinks";
             readonly duplicateChargeAlerts: "duplicateChargeAlerts";
+            readonly organizationBalance: "organizationBalance";
+            readonly organizationBalanceRollup: "organizationBalanceRollup";
         };
         getPath: ({ companyId, storeId, collectionName, id, }: {
             companyId: string;

package/dist/lib/firebase-api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/firebase-api/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DASrB;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,OAAO,gBAAgB,CAAC;QAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;KACZ;wFAUE;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,OAAO,gBAAgB,CAAC;QAC9C,iBAAiB,EAAE,MAAM,OAAO,gBAAgB,CAAC;QACjD,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;KACf;iCAI4B,MAAM,OAAO,gBAAgB;oCAIzC,MAAM,OAAO,gBAAgB,MACzC,MAAM,qBACS,MAAM,OAAO,gBAAgB;CAIjD,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAtCpB;YACF,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,cAAc,EAAE,MAAM,OAAO,gBAAgB,CAAC;YAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;SACZ;4FAUE;YACF,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,cAAc,EAAE,MAAM,OAAO,gBAAgB,CAAC;YAC9C,iBAAiB,EAAE,MAAM,OAAO,gBAAgB,CAAC;YACjD,EAAE,EAAE,MAAM,CAAC;YACX,KAAK,CAAC,EAAE,MAAM,CAAC;SACf;qCAI4B,MAAM,OAAO,gBAAgB;wCAIzC,MAAM,OAAO,gBAAgB,MACzC,MAAM,qBACS,MAAM,OAAO,gBAAgB;;CAQjD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/firebase-api/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DASrB;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,OAAO,gBAAgB,CAAC;QAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;KACZ;wFAUE;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,OAAO,gBAAgB,CAAC;QAC9C,iBAAiB,EAAE,MAAM,OAAO,gBAAgB,CAAC;QACjD,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;KACf;iCAI4B,MAAM,OAAO,gBAAgB;oCAIzC,MAAM,OAAO,gBAAgB,MACzC,MAAM,qBACS,MAAM,OAAO,gBAAgB;CAIjD,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAtCpB;YACF,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,cAAc,EAAE,MAAM,OAAO,gBAAgB,CAAC;YAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;SACZ;4FAUE;YACF,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,cAAc,EAAE,MAAM,OAAO,gBAAgB,CAAC;YAC9C,iBAAiB,EAAE,MAAM,OAAO,gBAAgB,CAAC;YACjD,EAAE,EAAE,MAAM,CAAC;YACX,KAAK,CAAC,EAAE,MAAM,CAAC;SACf;qCAI4B,MAAM,OAAO,gBAAgB;wCAIzC,MAAM,OAAO,gBAAgB,MACzC,MAAM,qBACS,MAAM,OAAO,gBAAgB;;CAQjD,CAAC"}

package/dist/lib/firebase-api/index.js

@@ -28,6 +28,8 @@ export const storeCollections = {
     transactions: "transactions",
     paymentLinks: "paymentLinks",
     duplicateChargeAlerts: "duplicateChargeAlerts",
+    organizationBalance: "organizationBalance",
+    organizationBalanceRollup: "organizationBalanceRollup",
 };
 export const FirestoreApi = {
     systemCollections,