@fayz-ai/plugin-shop 0.11.2 → 0.13.0

package/dist/views/stock-agent.d.ts

@@ -0,0 +1,82 @@
+import type { AgentSurfaceTool } from '@fayz-ai/admin';
+import type { ShopProvider } from '@fayz-ai/shop';
+export interface MovementPlan {
+    kind: string;
+    quantity: number;
+    reasonCode: string;
+}
+/**
+ * O que o lojista disse, traduzido para uma linha do razão.
+ *
+ * A razão manda na espécie quando ela implica uma: "saída por quebra" não é um
+ * ajuste com uma observação, é uma PERDA — e o relatório de perdas do mês
+ * depende dessa diferença. Por isso a tabela de razões é consultada antes de a
+ * espécie do verbo valer.
+ */
+export declare function planMovement(rawType: string, quantity: number, reasonCode?: string): MovementPlan | {
+    error: string;
+    message: string;
+};
+/**
+ * O razão não está NESTA loja.
+ *
+ * O ledger inteiro — `plg_shop_stock_balances`, `plg_shop_stock_movements`, e a
+ * coluna `tracking` na variante — nasce na migration 0034, e um pool que nunca
+ * a aplicou responde com o erro cru do PostgREST: "Could not find the table" ou
+ * "column ... does not exist". Isso é verdade e é ilegível para quem está
+ * tentando lançar uma nota, e pior: parece defeito da tela.
+ *
+ * Reconhecer a falta e dizer o nome dela é a diferença entre "o app quebrou" e
+ * "falta aplicar o estoque nesta loja".
+ */
+export declare function isLedgerMissing(error: unknown): boolean;
+export declare const LEDGER_MISSING_MESSAGE: string;
+/**
+ * A data que o lojista escolheu, virada em instante — ou nada.
+ *
+ * Duas armadilhas de uma vez. A primeira: mandar a data de HOJE é trocar o
+ * relógio do servidor pelo do navegador sem ganhar nada, então um dia não
+ * alterado devolve `undefined` e o razão carimba o próprio `now()`. A segunda:
+ * `new Date('2026-08-21')` é meia-noite UTC, que no Brasil é o dia 20 às 21h —
+ * uma nota lançada retroativa cairia um dia antes do que foi digitado. Meio-dia
+ * local sobrevive a qualquer fuso.
+ */
+export declare function occurredAtFor(chosenDay: string, today: string): string | undefined;
+export interface CommitMovementArgs {
+    variantId: string;
+    movementType: string;
+    quantity: number;
+    reasonCode?: string;
+    locationId?: string;
+    note?: string;
+    occurredAt?: string;
+}
+export interface CommittedMovement {
+    ok: true;
+    movementId: string;
+    kind: string;
+    quantity: number;
+    reasonCode: string;
+    available: number;
+}
+export interface RefusedMovement {
+    ok: false;
+    error: string;
+    message?: string;
+    available?: number;
+}
+/**
+ * O único caminho de gravação do razão — do formulário e do agente.
+ *
+ * Ter dois seria ter duas opiniões sobre o sinal, sobre a guarda de negativo e
+ * sobre qual razão implica qual espécie, e elas divergiriam na primeira vez que
+ * alguém mexesse num só. A porta é a mesma; o que muda é quem digita.
+ */
+export declare function commitMovement(args: CommitMovementArgs): Promise<CommittedMovement | RefusedMovement>;
+export interface StockAgentDeps {
+    getProvider: () => ShopProvider;
+    onChanged?: () => void;
+}
+export declare function createStockAgentTools({ getProvider, onChanged }: StockAgentDeps): AgentSurfaceTool[];
+export declare const STOCK_INSTRUCTIONS: string;
+//# sourceMappingURL=stock-agent.d.ts.map

package/dist/views/stock-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock-agent.d.ts","sourceRoot":"","sources":["../../src/views/stock-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,eAAe,CAAA;AA4C1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAsBnD;AA2DD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,eAAO,MAAM,sBAAsB,QAEsB,CAAA;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlF;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,IAAI,CAAA;IACR,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,GAAG,eAAe,CAAC,CA2D3G;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,YAAY,CAAA;IAC/B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAoCD,wBAAgB,qBAAqB,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,cAAc,GAAG,gBAAgB,EAAE,CA6FpG;AAED,eAAO,MAAM,kBAAkB,QASvB,CAAA"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@fayz-ai/plugin-shop",
   "fayz": {
-    "status": "preview"
+    "status": "preview",
+    "dependencies": []
   },
-  "version": "0.11.2",
+  "version": "0.13.0",
   "description": "[experimental] Fayz SDK — plugin-shop plugin",
   "type": "module",
   "sideEffects": false,
@@ -27,10 +28,11 @@
   },
   "dependencies": {
     "@tanstack/react-table": "^8.20.0",
-    "@fayz-ai/core": "^0.14.0",
-    "@fayz-ai/admin": "^0.14.0",
-    "@fayz-ai/shop": "^0.14.0",
-    "@fayz-ai/ui": "^0.14.0"
+    "@fayz-ai/core": "^0.16.0",
+    "@fayz-ai/admin": "^0.16.0",
+    "@fayz-ai/plugin-inventory": "^0.11.0",
+    "@fayz-ai/shop": "^0.16.0",
+    "@fayz-ai/ui": "^0.16.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",