@ah-oh/ao-workspaces-api-sdk 1.0.21 → 1.0.23

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 1.0.23 (2026-09-24)
+
+### 🚀 Features
+
+- **api-sdk:** add PrintClient for hardware connector print jobs ([7b1d334](https://github.com/ah-oh/ao-workspaces/commit/7b1d334))
+- update TypeScript configuration and ESLint migration documentation ([2993a37](https://github.com/ah-oh/ao-workspaces/commit/2993a37))
+
+### ❤️ Thank You
+
+- Claude Opus 5.5
+- Jan Kessler
+- Jan Keßler @jannks
+
+## 1.0.22 (2026-05-21)
+
+This was a version bump only for api-sdk to align it with other projects, there were no code changes.
+
 ## 1.0.21 (2026-03-19)
 
 This was a version bump only for api-sdk to align it with other projects, there were no code changes.

package/README.md

@@ -1,11 +1,96 @@
-# customer-center-sdk
+# api-sdk
 
 This library was generated with [Nx](https://nx.dev).
 
 ## Building
 
-Run `nx build customer-center-sdk` to build the library.
+Run `nx build api-sdk` to build the library.
 
 ## Running unit tests
 
-Run `nx test customer-center-sdk` to execute the unit tests via [Jest](https://jestjs.io).
+Run `nx test api-sdk` to execute the unit tests via [Jest](https://jestjs.io).
+
+## Drucken über den Hardware Connector
+
+Produkt-Apps drucken über den `PrintClient` auf **Druckziele** der Company
+(z. B. `shipping-label`). Welcher Drucker dahinter steht, legt die Company im
+Admin fest. Fachliche Regeln: `docs/features/hardware-connector/` im Repository
+`ah-oh/ao-workspaces`.
+
+Der `PrintClient` wird vom `AuthModule` bereitgestellt (`forRoot` oder
+`forRootAsync`) und meldet sich pro Aufruf mit dem User-Token der App an
+(`tokenId`, `tokenKey`). `product` ist die aufrufende App, **nicht** `admin` –
+nur so gilt der Aufruf als App und der Job trägt die App als Auslöser.
+
+```ts
+import { PrintClient, PrintClientError } from '@ah-oh/ao-workspaces-api-sdk';
+import { PrintContentType, Product } from '@ah-oh/ao-workspaces-types';
+
+const job = await printClient.print({
+  tokenId,
+  tokenKey,
+  product: Product.SZALES,
+  companyId,
+  target: 'shipping-label',
+  contentType: PrintContentType.ZPL,
+  content: Buffer.from(zpl),
+  fileName: `label-${orderId}.zpl`,
+  idempotencyKey: `label-${orderId}`,
+});
+
+const current = await printClient.getJob({
+  tokenId,
+  tokenKey,
+  product: Product.SZALES,
+  companyId,
+  jobId: job._id,
+});
+```
+
+| Methode              | Zweck                                                                                                                                                            |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `print`              | Legt einen Job an und liefert ihn im Zustand `queued`. Optionen: `copies` (1–99), bei PDF `paperSize` und `color`, `idempotencyKey`, `expiresInSeconds`.         |
+| `getJob`             | Liefert den aktuellen Zustand eines Jobs inklusive `error`.                                                                                                      |
+| `waitForJob`         | Fragt den Job ab, bis er abgeschlossen ist (`completed`, `failed`, `expired`, `canceled`) oder `timeoutMs` (Standard 60 s) vergangen ist. Meldet sich einmal an. |
+| `isFinal` (statisch) | Prüft, ob ein Job sich nicht mehr ändert. `waitForJob` liefert nach Ablauf der Wartezeit den letzten, noch offenen Zustand.                                      |
+
+Hinweise:
+
+- **Idempotenz:** Derselbe `idempotencyKey` liefert innerhalb einer Company
+  denselben Job zurück, statt erneut zu drucken. Für Wiederholungen nach
+  Netzwerkfehlern immer einen Schlüssel mitgeben.
+- **Ohne Verbindung:** Ist der Connector offline, bleibt der Job `queued` und
+  wird beim Wiederverbinden gedruckt – bis zur Ablaufzeit (Standard 1 Stunde,
+  über `expiresInSeconds` änderbar), danach `expired`.
+- **`completed`** heißt „vom Drucksystem angenommen“, nicht „physisch gedruckt“.
+
+### Fehler
+
+Fehler der Hardware-API werden als `PrintClientError` geworfen (abgeleitet von
+Nests `HttpException`). `code` enthält den maschinenlesbaren Fehlercode,
+`getStatus()` den HTTP-Status:
+
+| `code`                  | Status | Bedeutung                                                 |
+| ----------------------- | ------ | --------------------------------------------------------- |
+| `target_not_found`      | 404    | Druckziel gibt es in der Company nicht                    |
+| `target_unassigned`     | 422    | Druckziel ist keinem Drucker zugeordnet                   |
+| `option_not_allowed`    | 422    | `paperSize` oder `color` bei ZPL                          |
+| `content_type_mismatch` | 422    | Drucker bzw. Druckziel akzeptiert diesen Inhaltstyp nicht |
+| `printer_disabled`      | 422    | Zugeordneter Drucker ist nicht freigegeben                |
+| `content_missing`       | 400    | Kein Inhalt übergeben                                     |
+| `content_invalid`       | 422    | Inhalt ist kein gültiges PDF                              |
+| `content_too_large`     | 413    | Inhalt größer als 50 MB                                   |
+| `job_not_found`         | 404    | Job-ID unbekannt                                          |
+
+Validierungsfehler (400) und Netzwerkfehler (502) haben keinen `code`.
+
+```ts
+try {
+  await printClient.print({ ... });
+} catch (error) {
+  if (error instanceof PrintClientError && error.code === 'target_unassigned') {
+    // Hinweis an die Company: Druckziel im Admin einem Drucker zuordnen
+  }
+  throw error;
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ah-oh/ao-workspaces-api-sdk",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "type": "commonjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "tslib": "^2.3.0",
-    "@ah-oh/ao-workspaces-types": "^0.0.6"
+    "@ah-oh/ao-workspaces-types": "^0.0.10"
   },
   "peerDependencies": {
     "@nestjs/common": ">=9.0.0",

package/src/index.d.ts

@@ -13,3 +13,4 @@ export * from './lib/models/api-key.model';
 export * from './lib/auth.module';
 export * from './lib/customer-center.service';
 export * from './lib/mail-settings.service';
+export * from './lib/print.client';

package/src/index.js

@@ -16,4 +16,5 @@ tslib_1.__exportStar(require("./lib/models/api-key.model"), exports);
 tslib_1.__exportStar(require("./lib/auth.module"), exports);
 tslib_1.__exportStar(require("./lib/customer-center.service"), exports);
 tslib_1.__exportStar(require("./lib/mail-settings.service"), exports);
+tslib_1.__exportStar(require("./lib/print.client"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/api-sdk/src/index.ts"],"names":[],"mappings":";;;AAAA,kEAAwC;AACxC,+EAAqD;AACrD,6EAAmD;AACnD,qEAA2C;AAC3C,gFAAsD;AACtD,yEAA+C;AAE/C,+EAAqD;AACrD,oEAA0C;AAC1C,+EAAqD;AACrD,0EAAgD;AAChD,oEAA0C;AAC1C,qEAA2C;AAE3C,4DAAkC;AAClC,wEAA8C;AAC9C,sEAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/api-sdk/src/index.ts"],"names":[],"mappings":";;;AAAA,kEAAwC;AACxC,+EAAqD;AACrD,6EAAmD;AACnD,qEAA2C;AAC3C,gFAAsD;AACtD,yEAA+C;AAE/C,+EAAqD;AACrD,oEAA0C;AAC1C,+EAAqD;AACrD,0EAAgD;AAChD,oEAA0C;AAC1C,qEAA2C;AAE3C,4DAAkC;AAClC,wEAA8C;AAC9C,sEAA4C;AAC5C,6DAAmC"}

package/src/lib/auth.module.js

@@ -7,6 +7,7 @@ const common_1 = require("@nestjs/common");
 const auth_constants_1 = require("./auth.constants");
 const customer_center_service_1 = require("./customer-center.service");
 const mail_settings_service_1 = require("./mail-settings.service");
+const print_client_1 = require("./print.client");
 var auth_constants_2 = require("./auth.constants");
 Object.defineProperty(exports, "AUTH_MODULE_OPTIONS", { enumerable: true, get: function () { return auth_constants_2.AUTH_MODULE_OPTIONS; } });
 Object.defineProperty(exports, "AUTH_TOKEN", { enumerable: true, get: function () { return auth_constants_2.AUTH_TOKEN; } });
@@ -28,8 +29,9 @@ let AuthModule = AuthModule_1 = class AuthModule {
                 provider,
                 customer_center_service_1.CustomerCenterService,
                 mail_settings_service_1.MailSettingsService,
+                print_client_1.PrintClient,
             ],
-            exports: [provider, customer_center_service_1.CustomerCenterService, mail_settings_service_1.MailSettingsService],
+            exports: [provider, customer_center_service_1.CustomerCenterService, mail_settings_service_1.MailSettingsService, print_client_1.PrintClient],
         };
     }
     static forRootAsync(options) {
@@ -41,8 +43,8 @@ let AuthModule = AuthModule_1 = class AuthModule {
         return {
             module: AuthModule_1,
             imports: options.imports,
-            providers: [...this.createAsyncProviders(options), provider, customer_center_service_1.CustomerCenterService, mail_settings_service_1.MailSettingsService],
-            exports: [provider, customer_center_service_1.CustomerCenterService, mail_settings_service_1.MailSettingsService],
+            providers: [...this.createAsyncProviders(options), provider, customer_center_service_1.CustomerCenterService, mail_settings_service_1.MailSettingsService, print_client_1.PrintClient],
+            exports: [provider, customer_center_service_1.CustomerCenterService, mail_settings_service_1.MailSettingsService, print_client_1.PrintClient],
         };
     }
     static createAsyncProviders(options) {

package/src/lib/auth.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.module.js","sourceRoot":"","sources":["../../../../../libs/api-sdk/src/lib/auth.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAA+E;AAE/E,qDAAmE;AACnE,uEAAkE;AAClE,mEAA8D;AAO9D,mDAAgF;AAAvE,qHAAA,mBAAmB,OAAA;AAAE,4GAAA,UAAU,OAAA;AAAE,6GAAA,WAAW,OAAA;AAErD,MAAM,cAAc,GAAG,CAAC,OAA0B,EAAyB,EAAE,CACzE,IAAI,+CAAqB,CAAC,OAAO,CAAC,CAAC;AAEvC,MAAM,kBAAkB,GAAG,CAAC,OAA0B,EAAY,EAAE;IAChE,OAAO;QACH,OAAO,EAAE,2BAAU;QACnB,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC;KACpC,CAAC;AACN,CAAC,CAAC;AAIK,IAAM,UAAU,kBAAhB,MAAM,UAAU;IACZ,MAAM,CAAC,OAAO,CAAC,OAA0B;QAC5C,MAAM,QAAQ,GAAa,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO;YACH,MAAM,EAAE,YAAU;YAClB,SAAS,EAAE;gBACP,EAAE,OAAO,EAAE,oCAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACnD,QAAQ;gBACR,+CAAqB;gBACrB,2CAAmB;aACtB;YACD,OAAO,EAAE,CAAC,QAAQ,EAAE,+CAAqB,EAAE,2CAAmB,CAAC;SAClE,CAAC;IACN,CAAC;IAEM,MAAM,CAAC,YAAY,CAAC,OAA+B;QACtD,MAAM,QAAQ,GAAa;YACvB,MAAM,EAAE,CAAC,oCAAmB,CAAC;YAC7B,OAAO,EAAE,2BAAU;YACnB,UAAU,EAAE,KAAK,EAAE,OAA0B,EAAE,EAAE,CAC7C,cAAc,CAAC,OAAO,CAAC;SAC9B,CAAC;QAEF,OAAO;YACH,MAAM,EAAE,YAAU;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,+CAAqB,EAAE,2CAAmB,CAAC;YACxG,OAAO,EAAE,CAAC,QAAQ,EAAE,+CAAqB,EAAE,2CAAmB,CAAC;SAClE,CAAC;IACN,CAAC;IAEO,MAAM,CAAC,oBAAoB,CAC/B,OAA+B;QAE/B,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAmC,CAAC;QAE7D,OAAO;YACH,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC;YACxC;gBACI,OAAO,EAAE,QAAQ;gBACjB,QAAQ;aACX;SACJ,CAAC;IACN,CAAC;IAEO,MAAM,CAAC,0BAA0B,CACrC,OAA+B;QAE/B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;gBACH,OAAO,EAAE,oCAAmB;gBAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;aAC/B,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG;YACX,CAAC,OAAO,CAAC,QAAQ;gBACb,OAAO,CAAC,WAAW,CAA4B;SACtD,CAAC;QAEF,OAAO;YACH,OAAO,EAAE,oCAAmB;YAC5B,UAAU,EAAE,KAAK,EAAE,cAAiC,EAAE,EAAE,CACpD,MAAM,cAAc,CAAC,uBAAuB,EAAE;YAClD,MAAM;SACT,CAAC;IACN,CAAC;CACJ,CAAA;AAxEY,gCAAU;qBAAV,UAAU;IAFtB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,UAAU,CAwEtB"}
+{"version":3,"file":"auth.module.js","sourceRoot":"","sources":["../../../../../libs/api-sdk/src/lib/auth.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAA+E;AAE/E,qDAAmE;AACnE,uEAAkE;AAClE,mEAA8D;AAC9D,iDAA6C;AAO7C,mDAAgF;AAAvE,qHAAA,mBAAmB,OAAA;AAAE,4GAAA,UAAU,OAAA;AAAE,6GAAA,WAAW,OAAA;AAErD,MAAM,cAAc,GAAG,CAAC,OAA0B,EAAyB,EAAE,CACzE,IAAI,+CAAqB,CAAC,OAAO,CAAC,CAAC;AAEvC,MAAM,kBAAkB,GAAG,CAAC,OAA0B,EAAY,EAAE;IAChE,OAAO;QACH,OAAO,EAAE,2BAAU;QACnB,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC;KACpC,CAAC;AACN,CAAC,CAAC;AAIK,IAAM,UAAU,kBAAhB,MAAM,UAAU;IACZ,MAAM,CAAC,OAAO,CAAC,OAA0B;QAC5C,MAAM,QAAQ,GAAa,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO;YACH,MAAM,EAAE,YAAU;YAClB,SAAS,EAAE;gBACP,EAAE,OAAO,EAAE,oCAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACnD,QAAQ;gBACR,+CAAqB;gBACrB,2CAAmB;gBACnB,0BAAW;aACd;YACD,OAAO,EAAE,CAAC,QAAQ,EAAE,+CAAqB,EAAE,2CAAmB,EAAE,0BAAW,CAAC;SAC/E,CAAC;IACN,CAAC;IAEM,MAAM,CAAC,YAAY,CAAC,OAA+B;QACtD,MAAM,QAAQ,GAAa;YACvB,MAAM,EAAE,CAAC,oCAAmB,CAAC;YAC7B,OAAO,EAAE,2BAAU;YACnB,UAAU,EAAE,KAAK,EAAE,OAA0B,EAAE,EAAE,CAC7C,cAAc,CAAC,OAAO,CAAC;SAC9B,CAAC;QAEF,OAAO;YACH,MAAM,EAAE,YAAU;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,+CAAqB,EAAE,2CAAmB,EAAE,0BAAW,CAAC;YACrH,OAAO,EAAE,CAAC,QAAQ,EAAE,+CAAqB,EAAE,2CAAmB,EAAE,0BAAW,CAAC;SAC/E,CAAC;IACN,CAAC;IAEO,MAAM,CAAC,oBAAoB,CAC/B,OAA+B;QAE/B,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAmC,CAAC;QAE7D,OAAO;YACH,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC;YACxC;gBACI,OAAO,EAAE,QAAQ;gBACjB,QAAQ;aACX;SACJ,CAAC;IACN,CAAC;IAEO,MAAM,CAAC,0BAA0B,CACrC,OAA+B;QAE/B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;gBACH,OAAO,EAAE,oCAAmB;gBAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;aAC/B,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG;YACX,CAAC,OAAO,CAAC,QAAQ;gBACb,OAAO,CAAC,WAAW,CAA4B;SACtD,CAAC;QAEF,OAAO;YACH,OAAO,EAAE,oCAAmB;YAC5B,UAAU,EAAE,KAAK,EAAE,cAAiC,EAAE,EAAE,CACpD,MAAM,cAAc,CAAC,uBAAuB,EAAE;YAClD,MAAM;SACT,CAAC;IACN,CAAC;CACJ,CAAA;AAzEY,gCAAU;qBAAV,UAAU;IAFtB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,UAAU,CAyEtB"}

package/src/lib/print.client.d.ts

@@ -0,0 +1,75 @@
+import { IPrintJob, PrintColorMode, PrintContentType, PrintPaperSize, Product } from '@ah-oh/ao-workspaces-types';
+import { HttpException } from '@nestjs/common';
+import { CustomerCenterService } from './customer-center.service';
+import { TokenCredentials } from './mail-settings.service';
+import { AuthModuleOptions } from './models/auth.options';
+/**
+ * Credentials of a product app. `product` must be the calling app (e.g. `szales`),
+ * not `admin`: only app sessions may print on print targets without the admin
+ * permission `hardware`, and the job records the app as its origin.
+ */
+export interface PrintCredentials extends TokenCredentials {
+    product: Product;
+}
+export interface PrintArgs extends PrintCredentials {
+    companyId: string;
+    /** Key of a print target configured by the company, e.g. `shipping-label`. */
+    target: string;
+    contentType: PrintContentType;
+    /** Print-ready content: a PDF document or raw ZPL. At most 50 MB. */
+    content: Buffer | Uint8Array;
+    /** File name shown in the print history. Defaults to `content.<contentType>`. */
+    fileName?: string;
+    /** 1–99, default 1. */
+    copies?: number;
+    /** PDF only. */
+    paperSize?: PrintPaperSize;
+    /** PDF only. */
+    color?: PrintColorMode;
+    /** The same key within a company always returns the same job instead of printing again. */
+    idempotencyKey?: string;
+    /** 10–604800 seconds; the job expires unprinted afterwards. Default on the server: 3600. */
+    expiresInSeconds?: number;
+}
+export interface GetPrintJobArgs extends PrintCredentials {
+    companyId: string;
+    jobId: string;
+}
+export interface WaitForPrintJobArgs extends GetPrintJobArgs {
+    /** Maximum time to wait. Default 60000 ms. */
+    timeoutMs?: number;
+    /** Pause between two polls. Default 2000 ms. */
+    intervalMs?: number;
+}
+/**
+ * Error of the hardware API. `code` is the machine-readable code of the body
+ * `{ type: 'error', code, message }` (e.g. `target_unassigned`,
+ * `target_not_found`, `option_not_allowed`, `content_too_large`). It is
+ * undefined for errors without such a body (validation, network).
+ */
+export declare class PrintClientError extends HttpException {
+    readonly code: string | undefined;
+    constructor(code: string | undefined, message: string, status: number);
+}
+/** Creates print jobs on the hardware connector API and reads their state (HC-12). */
+export declare class PrintClient {
+    private readonly options;
+    private readonly customerCenterService;
+    private readonly BASE_URL;
+    constructor(options: AuthModuleOptions, customerCenterService: CustomerCenterService);
+    /** True once the job will not change anymore (completed, failed, expired, canceled). */
+    static isFinal(job: Pick<IPrintJob, 'state'>): boolean;
+    /** Creates a print job on a print target. Resolves as soon as the job is queued. */
+    print(args: PrintArgs): Promise<IPrintJob>;
+    getJob(args: GetPrintJobArgs): Promise<IPrintJob>;
+    /**
+     * Polls the job until it reaches a final state or `timeoutMs` has passed.
+     * On timeout the last known (non-final) job is returned; check it with
+     * `PrintClient.isFinal`. A job for an offline connector stays `queued` until
+     * it expires.
+     */
+    waitForJob(args: WaitForPrintJobArgs): Promise<IPrintJob>;
+    private fetchJob;
+    private getAuthorizationHeader;
+    private request;
+}

package/src/lib/print.client.js

@@ -0,0 +1,140 @@
+"use strict";
+var PrintClient_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrintClient = exports.PrintClientError = void 0;
+const tslib_1 = require("tslib");
+const ao_workspaces_types_1 = require("@ah-oh/ao-workspaces-types");
+const common_1 = require("@nestjs/common");
+const axios_1 = require("axios");
+const auth_constants_1 = require("./auth.constants");
+const customer_center_service_1 = require("./customer-center.service");
+/**
+ * Error of the hardware API. `code` is the machine-readable code of the body
+ * `{ type: 'error', code, message }` (e.g. `target_unassigned`,
+ * `target_not_found`, `option_not_allowed`, `content_too_large`). It is
+ * undefined for errors without such a body (validation, network).
+ */
+class PrintClientError extends common_1.HttpException {
+    code;
+    constructor(code, message, status) {
+        super({ type: 'error', code, message }, status);
+        this.code = code;
+        this.name = 'PrintClientError';
+        this.message = message;
+    }
+}
+exports.PrintClientError = PrintClientError;
+const CONTENT_MIME_TYPES = {
+    [ao_workspaces_types_1.PrintContentType.PDF]: 'application/pdf',
+    [ao_workspaces_types_1.PrintContentType.ZPL]: 'application/octet-stream',
+};
+const DEFAULT_WAIT_TIMEOUT_MS = 60_000;
+const DEFAULT_WAIT_INTERVAL_MS = 2_000;
+/** Creates print jobs on the hardware connector API and reads their state (HC-12). */
+let PrintClient = PrintClient_1 = class PrintClient {
+    options;
+    customerCenterService;
+    BASE_URL;
+    constructor(options, customerCenterService) {
+        this.options = options;
+        this.customerCenterService = customerCenterService;
+        this.BASE_URL = this.options.baseUrl;
+    }
+    /** True once the job will not change anymore (completed, failed, expired, canceled). */
+    static isFinal(job) {
+        return ao_workspaces_types_1.FINAL_PRINT_JOB_STATES.includes(job.state);
+    }
+    /** Creates a print job on a print target. Resolves as soon as the job is queued. */
+    async print(args) {
+        const authorization = await this.getAuthorizationHeader(args);
+        const form = new FormData();
+        form.append('target', args.target);
+        form.append('contentType', args.contentType);
+        if (args.copies !== undefined)
+            form.append('copies', String(args.copies));
+        if (args.paperSize)
+            form.append('paperSize', args.paperSize);
+        if (args.color)
+            form.append('color', args.color);
+        if (args.idempotencyKey)
+            form.append('idempotencyKey', args.idempotencyKey);
+        if (args.expiresInSeconds !== undefined)
+            form.append('expiresInSeconds', String(args.expiresInSeconds));
+        form.append('content', new Blob([args.content], {
+            type: CONTENT_MIME_TYPES[args.contentType],
+        }), args.fileName ?? `content.${args.contentType}`);
+        return this.request({
+            method: 'POST',
+            url: `/auth-api/companies/${args.companyId}/hardware/print-jobs`,
+            headers: { accept: 'application/json', authorization },
+            data: form,
+            maxBodyLength: Infinity,
+        });
+    }
+    async getJob(args) {
+        const authorization = await this.getAuthorizationHeader(args);
+        return this.fetchJob(args, authorization);
+    }
+    /**
+     * Polls the job until it reaches a final state or `timeoutMs` has passed.
+     * On timeout the last known (non-final) job is returned; check it with
+     * `PrintClient.isFinal`. A job for an offline connector stays `queued` until
+     * it expires.
+     */
+    async waitForJob(args) {
+        const timeoutMs = args.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
+        const intervalMs = args.intervalMs ?? DEFAULT_WAIT_INTERVAL_MS;
+        const deadline = Date.now() + timeoutMs;
+        const authorization = await this.getAuthorizationHeader(args);
+        let job = await this.fetchJob(args, authorization);
+        while (!PrintClient_1.isFinal(job) && Date.now() + intervalMs <= deadline) {
+            await new Promise(resolve => setTimeout(resolve, intervalMs));
+            job = await this.fetchJob(args, authorization);
+        }
+        return job;
+    }
+    fetchJob(args, authorization) {
+        return this.request({
+            method: 'GET',
+            url: `/auth-api/companies/${args.companyId}/hardware/print-jobs/${args.jobId}`,
+            headers: { accept: 'application/json', authorization },
+        });
+    }
+    async getAuthorizationHeader(credentials) {
+        const { token } = await this.customerCenterService.tokenSignIn({
+            tokenId: credentials.tokenId,
+            tokenKey: credentials.tokenKey,
+            product: credentials.product,
+        });
+        return `Bearer ${token}`;
+    }
+    async request(config) {
+        try {
+            const res = await axios_1.default.request({ ...config, baseURL: this.BASE_URL });
+            return res.data;
+        }
+        catch (error) {
+            throw toPrintClientError(error);
+        }
+    }
+};
+exports.PrintClient = PrintClient;
+exports.PrintClient = PrintClient = PrintClient_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(auth_constants_1.AUTH_MODULE_OPTIONS)),
+    tslib_1.__metadata("design:paramtypes", [Object, customer_center_service_1.CustomerCenterService])
+], PrintClient);
+function toPrintClientError(error) {
+    if (!(error instanceof axios_1.AxiosError))
+        return error;
+    const status = error.response?.status ?? common_1.HttpStatus.BAD_GATEWAY;
+    const body = error.response?.data;
+    const code = typeof body?.code === 'string' ? body.code : undefined;
+    const message = Array.isArray(body?.message)
+        ? body.message.join('; ')
+        : typeof body?.message === 'string'
+            ? body.message
+            : error.message;
+    return new PrintClientError(code, message, status);
+}
+//# sourceMappingURL=print.client.js.map

package/src/lib/print.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.client.js","sourceRoot":"","sources":["../../../../../libs/api-sdk/src/lib/print.client.ts"],"names":[],"mappings":"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"}