@stacksjs/commerce 0.75.170 → 0.75.172

package/dist/fiskaly.d.ts

@@ -1,22 +1,5 @@
 /** A fiskaly SIGN DE client for one API key. Tokens are cached and refreshed. */
-export declare function fiskalySignDe(options: FiskalyOptions): {
-  status: unknown.status;
-  json: unknown
-} | {
-  authenticate: () => Promise<{ organizationId: string | null, environment: string | null }>;
-  createTss: (tssId: string, metadata?: Record<string, string>) => boolean;
-  retrieveTss: (tssId: string) => boolean;
-  setTssState: (tssId: string, state: 'UNINITIALIZED' | 'INITIALIZED' | 'DISABLED') => boolean;
-  changeAdminPin: (tssId: string, adminPuk: string, newAdminPin: string) => unknown;
-  authenticateAdmin: (tssId: string, adminPin: string) => unknown;
-  logoutAdmin: (tssId: string) => unknown;
-  upsertClient: (tssId: string, clientId: string, serialNumber: string) => boolean;
-  retrieveClient: (tssId: string, clientId: string) => boolean;
-  startTransaction: (tssId: string, txId: string, clientId: string) => boolean;
-  finishTransaction: (tssId: string, txId: string, clientId: string, receipt: FiskalyReceipt, revision?: number) => boolean;
-  cancelTransaction: (tssId: string, txId: string, clientId: string, revision?: number) => boolean;
-  retrieveTransaction: (tssId: string, txId: string) => boolean
-};
+export declare function fiskalySignDe(options: FiskalyOptions): FiskalySignDe;
 /**
  * Takes a TSS from nothing (or from wherever an earlier attempt stopped) to
  * INITIALIZED with this till registered as its client. Each step is safe to
@@ -114,6 +97,22 @@ export declare interface FiskalyTransaction {
   log?: { operation: string, timestamp: number, timestamp_format: string }
   schema?: { standard_v1?: { receipt?: FiskalyReceipt } }
 }
+/** The calls a till makes to fiskaly SIGN DE with one API key. */
+export declare interface FiskalySignDe {
+  authenticate: () => Promise<{ organizationId: string | null, environment: string | null }>
+  createTss: (tssId: string, metadata?: Record<string, string>) => Promise<FiskalyTss>
+  retrieveTss: (tssId: string) => Promise<FiskalyTss>
+  setTssState: (tssId: string, state: 'UNINITIALIZED' | 'INITIALIZED' | 'DISABLED') => Promise<FiskalyTss>
+  changeAdminPin: (tssId: string, adminPuk: string, newAdminPin: string) => Promise<Record<string, never>>
+  authenticateAdmin: (tssId: string, adminPin: string) => Promise<Record<string, never>>
+  logoutAdmin: (tssId: string) => Promise<Record<string, never>>
+  upsertClient: (tssId: string, clientId: string, serialNumber: string) => Promise<FiskalyClient>
+  retrieveClient: (tssId: string, clientId: string) => Promise<FiskalyClient>
+  startTransaction: (tssId: string, txId: string, clientId: string) => Promise<FiskalyTransaction>
+  finishTransaction: (tssId: string, txId: string, clientId: string, receipt: FiskalyReceipt, revision?: number) => Promise<FiskalyTransaction>
+  cancelTransaction: (tssId: string, txId: string, clientId: string, revision?: number) => Promise<FiskalyTransaction>
+  retrieveTransaction: (tssId: string, txId: string) => Promise<FiskalyTransaction>
+}
 export declare interface ProvisionInput {
   tssId: string
   clientId: string
@@ -132,7 +131,6 @@ export type TssState = 'CREATED' | 'UNINITIALIZED' | 'INITIALIZED' | 'DISABLED'
 export type FiskalyVatRate = 'NORMAL' | 'REDUCED_1' | 'SPECIAL_RATE_1' | 'SPECIAL_RATE_2' | 'NULL';
 export type FiskalyPaymentType = 'CASH' | 'NON_CASH';
 export type FiskalyReceiptType = 'RECEIPT' | 'TRAINING' | 'TRANSFER' | 'ORDER' | 'CANCELLATION' | 'ABORT' | 'BENEFIT_IN_KIND' | 'INVOICE' | 'OTHER';
-export type FiskalySignDe = ReturnType<typeof fiskalySignDe>;
 export declare class FiskalyError extends Error {
   readonly failure: FiskalyFailure;
   readonly status: number;

package/dist/kassensichv.d.ts

@@ -15,11 +15,7 @@ export declare function tseAmount(cents: number): string;
  */
 export declare function processData(input: { bonTyp?: BonTyp, vat: readonly TseVatAmount[], payments: readonly TsePayment[] }): string;
 /** fiskaly's receipt schema (`schema.standard_v1.receipt`) for the same amounts. */
-export declare function fiskalyReceiptFor(input: { vat: readonly TseVatAmount[], payments: readonly TsePayment[], receiptType?: 'RECEIPT' | 'TRAINING' | 'TRANSFER' | 'ORDER' | 'CANCELLATION' | 'ABORT' | 'BENEFIT_IN_KIND' | 'INVOICE' | 'OTHER' }): {
-  receipt_type: unknown;
-  amounts_per_vat_rate: unknown;
-  amounts_per_payment_type: unknown
-};
+export declare function fiskalyReceiptFor(input: { vat: readonly TseVatAmount[], payments: readonly TsePayment[], receiptType?: FiskalyReceiptSchema['receipt_type'] }): FiskalyReceiptSchema;
 /** A TSE time as receipts and the export write it: `YYYY-MM-DDThh:mm:ss.fffZ` (UTC). Takes unix seconds, an ISO string or a Date. */
 export declare function tseTime(value: number | string | Date): string;
 /** The receipt's QR code content (DSFinV-K Anhang I): twelve fields joined by ";", starting with "V0". */
@@ -80,6 +76,12 @@ export declare const DE_VAT_KEYS: {
 export declare const TSE_FAILURE_NOTICE: 'TSE ausgefallen';
 export declare interface TseVatAmount { key: DeVatKey, grossCents: number }
 export declare interface TsePayment { kind: TsePaymentKind, cents: number,   currency?: string }
+/** fiskaly's receipt schema (`schema.standard_v1.receipt`), as `fiskalyReceiptFor` writes it. */
+export declare interface FiskalyReceiptSchema {
+  receipt_type: 'RECEIPT' | 'TRAINING' | 'TRANSFER' | 'ORDER' | 'CANCELLATION' | 'ABORT' | 'BENEFIT_IN_KIND' | 'INVOICE' | 'OTHER'
+  amounts_per_vat_rate: Array<{ vat_rate: 'NORMAL' | 'REDUCED_1' | 'SPECIAL_RATE_1' | 'SPECIAL_RATE_2' | 'NULL', amount: string }>
+  amounts_per_payment_type: Array<{ payment_type: 'CASH' | 'NON_CASH', amount: string, currency_code?: string }>
+}
 export declare interface ReceiptQrInput {
   clientSerialNumber: string
   processType: 'Kassenbeleg-V1' | 'Bestellung-V1' | 'SonstigerVorgang'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/commerce",
   "type": "module",
-  "version": "0.75.170",
+  "version": "0.75.172",
   "description": "Stacks commerce utilities.",
   "author": "Chris Breuer",
   "contributors": [
@@ -57,18 +57,18 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/cache": "0.75.170",
-    "@stacksjs/config": "0.75.170",
-    "@stacksjs/database": "0.75.170",
-    "@stacksjs/env": "0.75.170",
-    "@stacksjs/error-handling": "0.75.170",
-    "@stacksjs/events": "0.75.170",
-    "@stacksjs/logging": "0.75.170",
-    "@stacksjs/orm": "0.75.170",
-    "@stacksjs/payments": "0.75.170",
-    "@stacksjs/realtime": "0.75.170",
-    "@stacksjs/strings": "0.75.170",
-    "@stacksjs/validation": "0.75.170",
+    "@stacksjs/cache": "0.75.172",
+    "@stacksjs/config": "0.75.172",
+    "@stacksjs/database": "0.75.172",
+    "@stacksjs/env": "0.75.172",
+    "@stacksjs/error-handling": "0.75.172",
+    "@stacksjs/events": "0.75.172",
+    "@stacksjs/logging": "0.75.172",
+    "@stacksjs/orm": "0.75.172",
+    "@stacksjs/payments": "0.75.172",
+    "@stacksjs/realtime": "0.75.172",
+    "@stacksjs/strings": "0.75.172",
+    "@stacksjs/validation": "0.75.172",
     "ts-spreadsheets": "^0.2.0"
   },
   "devDependencies": {