@jsdev_ninja/core 0.15.0 → 0.15.1

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

@@ -1,97 +1,106 @@
 import { z } from "zod";
-export declare const BudgetTransactionTypeSchema: z.ZodEnum<["delivery_note", "payment_received", "credit_note", "debit_note", "order_created", "order_cancelled", "order_refunded"]>;
-export declare const PaymentMethodSchema: z.ZodEnum<["check", "bank_transfer", "cash", "credit_card", "other"]>;
-export declare const BudgetTransactionSchema: z.ZodObject<{
-    id: z.ZodString;
-    type: z.ZodEnum<["delivery_note", "payment_received", "credit_note", "debit_note", "order_created", "order_cancelled", "order_refunded"]>;
-    debt: z.ZodNumber;
-    runningBalance: z.ZodNumber;
-    orderId: z.ZodNullable<z.ZodString>;
-    orderTotal: z.ZodNullable<z.ZodNumber>;
-    deliveryNoteId: z.ZodNullable<z.ZodString>;
-    deliveryNoteNumber: z.ZodNullable<z.ZodString>;
+export declare const BudgetRecordTypeSchema: z.ZodEnum<["debt_increase", "debt_reduction"]>;
+export type TBudgetRecordType = z.infer<typeof BudgetRecordTypeSchema>;
+export declare const BudgetRecordSchema: z.ZodObject<{
+    recordId: z.ZodString;
+    organizationId: z.ZodString;
+    customerId: z.ZodString;
+    customerName: z.ZodString;
     billingAccountId: z.ZodNullable<z.ZodString>;
-    billingAccountName: z.ZodNullable<z.ZodString>;
-    billingAccountNumber: z.ZodNullable<z.ZodString>;
-    paymentReference: z.ZodNullable<z.ZodString>;
-    paymentDate: z.ZodNullable<z.ZodNumber>;
-    paymentMethod: z.ZodNullable<z.ZodEnum<["check", "bank_transfer", "cash", "credit_card", "other"]>>;
-    note: z.ZodNullable<z.ZodString>;
+    type: z.ZodEnum<["debt_increase", "debt_reduction"]>;
+    /** Integer agorot, always positive */
+    amount: z.ZodNumber;
+    currency: z.ZodLiteral<"ILS">;
+    /** orderId (debt_increase) | ledger transactionId (debt_reduction) */
+    relatedId: z.ZodString;
+    source: z.ZodEnum<["order", "ledger", "manual"]>;
+    /** event that caused this — trace + idempotency key; null for manual */
+    causedByEventId: z.ZodNullable<z.ZodString>;
+    /** epoch millis */
     createdAt: z.ZodNumber;
-    createdBy: z.ZodString;
+    /** Asia/Jerusalem date parts */
+    year: z.ZodNumber;
+    month: z.ZodNumber;
+    /** "2026-05" */
+    yearMonth: z.ZodString;
+    companyId: z.ZodString;
+    storeId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: "delivery_note" | "payment_received" | "credit_note" | "debit_note" | "order_created" | "order_cancelled" | "order_refunded";
-    id: string;
+    type: "debt_increase" | "debt_reduction";
+    companyId: string;
+    storeId: string;
+    currency: "ILS";
+    amount: number;
+    organizationId: string;
     createdAt: number;
-    createdBy: string;
-    debt: number;
-    runningBalance: number;
-    orderId: string | null;
-    orderTotal: number | null;
-    deliveryNoteId: string | null;
-    deliveryNoteNumber: string | null;
+    recordId: string;
+    customerId: string;
+    customerName: string;
     billingAccountId: string | null;
-    billingAccountName: string | null;
-    billingAccountNumber: string | null;
-    paymentReference: string | null;
-    paymentDate: number | null;
-    paymentMethod: "check" | "bank_transfer" | "cash" | "credit_card" | "other" | null;
-    note: string | null;
+    relatedId: string;
+    source: "order" | "ledger" | "manual";
+    causedByEventId: string | null;
+    year: number;
+    month: number;
+    yearMonth: string;
 }, {
-    type: "delivery_note" | "payment_received" | "credit_note" | "debit_note" | "order_created" | "order_cancelled" | "order_refunded";
-    id: string;
+    type: "debt_increase" | "debt_reduction";
+    companyId: string;
+    storeId: string;
+    currency: "ILS";
+    amount: number;
+    organizationId: string;
     createdAt: number;
-    createdBy: string;
-    debt: number;
-    runningBalance: number;
-    orderId: string | null;
-    orderTotal: number | null;
-    deliveryNoteId: string | null;
-    deliveryNoteNumber: string | null;
+    recordId: string;
+    customerId: string;
+    customerName: string;
     billingAccountId: string | null;
-    billingAccountName: string | null;
-    billingAccountNumber: string | null;
-    paymentReference: string | null;
-    paymentDate: number | null;
-    paymentMethod: "check" | "bank_transfer" | "cash" | "credit_card" | "other" | null;
-    note: string | null;
+    relatedId: string;
+    source: "order" | "ledger" | "manual";
+    causedByEventId: string | null;
+    year: number;
+    month: number;
+    yearMonth: string;
 }>;
-export declare const BudgetAccountSchema: z.ZodObject<{
-    id: z.ZodString;
+export type TBudgetRecord = z.infer<typeof BudgetRecordSchema>;
+export declare const OrganizationBudgetSchema: z.ZodObject<{
+    /** = doc id */
     organizationId: z.ZodString;
     organizationName: z.ZodString;
-    companyId: z.ZodString;
-    storeId: z.ZodString;
+    /** integer agorot — current outstanding debt */
+    totalCurrentDebt: z.ZodNumber;
+    /** lifetime sums (agorot) */
     totalDebits: z.ZodNumber;
     totalCredits: z.ZodNumber;
-    balance: z.ZodNumber;
     currency: z.ZodLiteral<"ILS">;
+    /** epoch millis */
     updatedAt: z.ZodNumber;
+    companyId: z.ZodString;
+    storeId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    id: string;
     companyId: string;
     storeId: string;
     currency: "ILS";
     organizationId: string;
     updatedAt: number;
     organizationName: string;
+    totalCurrentDebt: number;
     totalDebits: number;
     totalCredits: number;
-    balance: number;
 }, {
-    id: string;
     companyId: string;
     storeId: string;
     currency: "ILS";
     organizationId: string;
     updatedAt: number;
     organizationName: string;
+    totalCurrentDebt: number;
     totalDebits: number;
     totalCredits: number;
-    balance: number;
 }>;
+export type TOrganizationBudget = z.infer<typeof OrganizationBudgetSchema>;
+export declare const BudgetTransactionTypeSchema: z.ZodEnum<["delivery_note", "payment_received", "credit_note", "debit_note", "order_created", "order_cancelled", "order_refunded"]>;
+export declare const PaymentMethodSchema: z.ZodEnum<["check", "bank_transfer", "cash", "credit_card", "other"]>;
 export type TBudgetTransactionType = z.infer<typeof BudgetTransactionTypeSchema>;
 export type TPaymentMethod = z.infer<typeof PaymentMethodSchema>;
-export type TBudgetTransaction = z.infer<typeof BudgetTransactionSchema>;
-export type TBudgetAccount = z.infer<typeof BudgetAccountSchema>;
 //# sourceMappingURL=Budget.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Budget.d.ts","sourceRoot":"","sources":["../../../lib/entities/Budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,2BAA2B,qIAQtC,CAAC;AAEH,eAAO,MAAM,mBAAmB,uEAAqE,CAAC;AAEtG,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BlC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa9B,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACzE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"Budget.d.ts","sourceRoot":"","sources":["../../../lib/entities/Budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,sBAAsB,gDAA8C,CAAC;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,eAAO,MAAM,kBAAkB;;;;;;;IAO9B,sCAAsC;;;IAGtC,sEAAsE;;;IAGtE,wEAAwE;;IAExE,mBAAmB;;IAEnB,gCAAgC;;;IAGhC,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIf,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,wBAAwB;IACpC,eAAe;;;IAGf,gDAAgD;;IAEhD,6BAA6B;;;;IAI7B,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAIlB,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM3E,eAAO,MAAM,2BAA2B,qIAQtC,CAAC;AAEH,eAAO,MAAM,mBAAmB,uEAAqE,CAAC;AAEtG,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/lib/entities/Budget.js

@@ -1,4 +1,51 @@
 import { z } from "zod";
+// ---------------------------------------------------------------------------
+// New flat collections (target model — B0)
+// ---------------------------------------------------------------------------
+export const BudgetRecordTypeSchema = z.enum(["debt_increase", "debt_reduction"]);
+export const BudgetRecordSchema = z.object({
+    recordId: z.string().min(1),
+    organizationId: z.string().min(1),
+    customerId: z.string(), // "system" when no acting user
+    customerName: z.string(),
+    billingAccountId: z.string().nullable(),
+    type: BudgetRecordTypeSchema,
+    /** Integer agorot, always positive */
+    amount: z.number().int().positive(),
+    currency: z.literal("ILS"),
+    /** orderId (debt_increase) | ledger transactionId (debt_reduction) */
+    relatedId: z.string().min(1),
+    source: z.enum(["order", "ledger", "manual"]),
+    /** event that caused this — trace + idempotency key; null for manual */
+    causedByEventId: z.string().nullable(),
+    /** epoch millis */
+    createdAt: z.number().int().positive(),
+    /** Asia/Jerusalem date parts */
+    year: z.number().int(),
+    month: z.number().int().min(1).max(12),
+    /** "2026-05" */
+    yearMonth: z.string(),
+    companyId: z.string().min(1),
+    storeId: z.string().min(1),
+});
+export const OrganizationBudgetSchema = z.object({
+    /** = doc id */
+    organizationId: z.string().min(1),
+    organizationName: z.string(),
+    /** integer agorot — current outstanding debt */
+    totalCurrentDebt: z.number().int(),
+    /** lifetime sums (agorot) */
+    totalDebits: z.number().int(),
+    totalCredits: z.number().int(),
+    currency: z.literal("ILS"),
+    /** epoch millis */
+    updatedAt: z.number().int().positive(),
+    companyId: z.string().min(1),
+    storeId: z.string().min(1),
+});
+// ---------------------------------------------------------------------------
+// Legacy collections (kept for backward compatibility — data left inert)
+// ---------------------------------------------------------------------------
 export const BudgetTransactionTypeSchema = z.enum([
     "delivery_note",
     "payment_received",
@@ -9,39 +56,3 @@ export const BudgetTransactionTypeSchema = z.enum([
     "order_refunded", // legacy
 ]);
 export const PaymentMethodSchema = z.enum(["check", "bank_transfer", "cash", "credit_card", "other"]);
-export const BudgetTransactionSchema = z.object({
-    id: z.string(),
-    type: BudgetTransactionTypeSchema,
-    // positive = debt added (delivery note / debit note), negative = debt reduced (payment / credit)
-    debt: z.number(),
-    runningBalance: z.number(),
-    // order reference
-    orderId: z.string().nullable(),
-    orderTotal: z.number().nullable(),
-    // delivery note reference (for delivery_note type)
-    deliveryNoteId: z.string().nullable(),
-    deliveryNoteNumber: z.string().nullable(),
-    // billing account snapshot (if order had one)
-    billingAccountId: z.string().nullable(),
-    billingAccountName: z.string().nullable(),
-    billingAccountNumber: z.string().nullable(),
-    // payment details (for payment_received type — entered by admin)
-    paymentReference: z.string().nullable(), // check number, bank transfer ref, etc.
-    paymentDate: z.number().nullable(), // timestamp
-    paymentMethod: PaymentMethodSchema.nullable(),
-    note: z.string().nullable(),
-    createdAt: z.number(),
-    createdBy: z.string(), // userId or "system"
-});
-export const BudgetAccountSchema = z.object({
-    id: z.string(), // organizationId
-    organizationId: z.string(),
-    organizationName: z.string(),
-    companyId: z.string(),
-    storeId: z.string(),
-    totalDebits: z.number(), // sum of delivery note amounts
-    totalCredits: z.number(), // sum of payments received
-    balance: z.number(), // totalDebits - totalCredits (positive = owes money)
-    currency: z.literal("ILS"),
-    updatedAt: z.number(),
-});