@firfi/voila-sdk 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +6 -3
  2. package/dist/src/domain/schemas/index.d.ts +2 -0
  3. package/dist/src/domain/schemas/index.d.ts.map +1 -1
  4. package/dist/src/domain/schemas/index.js +2 -0
  5. package/dist/src/domain/schemas/index.js.map +1 -1
  6. package/dist/src/domain/schemas/order-details.d.ts +2623 -0
  7. package/dist/src/domain/schemas/order-details.d.ts.map +1 -0
  8. package/dist/src/domain/schemas/order-details.js +148 -0
  9. package/dist/src/domain/schemas/order-details.js.map +1 -0
  10. package/dist/src/domain/schemas/order-history.d.ts +738 -0
  11. package/dist/src/domain/schemas/order-history.d.ts.map +1 -0
  12. package/dist/src/domain/schemas/order-history.js +113 -0
  13. package/dist/src/domain/schemas/order-history.js.map +1 -0
  14. package/dist/src/domain/schemas/slot.d.ts +4 -4
  15. package/dist/src/index.d.ts +3 -0
  16. package/dist/src/index.d.ts.map +1 -1
  17. package/dist/src/index.js +3 -0
  18. package/dist/src/index.js.map +1 -1
  19. package/dist/src/voila/browser-login-adapter.d.ts +12 -12
  20. package/dist/src/voila/order-details.d.ts +22 -0
  21. package/dist/src/voila/order-details.d.ts.map +1 -0
  22. package/dist/src/voila/order-details.js +267 -0
  23. package/dist/src/voila/order-details.js.map +1 -0
  24. package/dist/src/voila/order-history.d.ts +18 -0
  25. package/dist/src/voila/order-history.d.ts.map +1 -0
  26. package/dist/src/voila/order-history.js +102 -0
  27. package/dist/src/voila/order-history.js.map +1 -0
  28. package/dist/src/voila/order-urls.d.ts +23 -0
  29. package/dist/src/voila/order-urls.d.ts.map +1 -0
  30. package/dist/src/voila/order-urls.js +90 -0
  31. package/dist/src/voila/order-urls.js.map +1 -0
  32. package/package.json +1 -1
package/README.md CHANGED
@@ -78,6 +78,9 @@ console.log(search.right.value.products.map((product) => product.name))
78
78
  - Delivery destination/context reads and guarded delivery context changes.
79
79
  - Slot listing and guarded slot reservation input helpers.
80
80
  - Checkout summary/readiness review.
81
+ - Completed order history reads with cursor pagination.
82
+ - Completed order detail reads with item groups, quantities, prices, and substitution/missing/return status.
83
+ - Completed-order item aggregation for questions like "what did I order last month?"
81
84
  - Session snapshot save/load helpers.
82
85
 
83
86
  The SDK does not place orders. Checkout APIs stop at review/readiness so a human can confirm in Voila.
@@ -103,7 +106,7 @@ That file is sensitive and ignored by git. Use it with `loadSdkSessionSnapshot`
103
106
  Import only from the package entrypoint:
104
107
 
105
108
  ```ts
106
- import { addCartItems, getCart, searchProducts } from "@firfi/voila-sdk"
109
+ import { addCartItems, getCart, getCompletedOrderItems, getCompletedOrders, getOrderDetails, searchProducts } from "@firfi/voila-sdk"
107
110
  ```
108
111
 
109
112
  Deep imports are unsupported. See [docs/public-api.md](docs/public-api.md) for the full public surface and [docs/usage-examples.md](docs/usage-examples.md) for end-to-end examples.
@@ -152,9 +155,9 @@ npm publish
152
155
 
153
156
  The package tarball intentionally contains only `package.json`, `README.md`, `LICENSE`, and `dist/src/**`. See [docs/release.md](docs/release.md).
154
157
 
155
- ## Future MCP
158
+ ## MCP And CLI
156
159
 
157
- The current package is library-first. The codebase is prepared for a future MCP server by keeping all Voila behavior behind typed SDK functions and explicit ports. The MCP package/server should be added later as a separate entrypoint or package that depends on this SDK surface rather than duplicating endpoint logic. See [docs/mcp-readiness.md](docs/mcp-readiness.md).
160
+ The workspace also publishes `@firfi/voila-mcp` and `@firfi/voila-cli`. Both use this SDK for Voila endpoint behavior; MCP owns the shared operation registry and the CLI reuses it. See [docs/mcp-readiness.md](docs/mcp-readiness.md).
158
161
 
159
162
  ## Safety
160
163
 
@@ -5,6 +5,8 @@ export * from "./category.js";
5
5
  export * from "./checkout-summary.js";
6
6
  export * from "./delivery-destination.js";
7
7
  export * from "./money.js";
8
+ export * from "./order-details.js";
9
+ export * from "./order-history.js";
8
10
  export * from "./product.js";
9
11
  export * from "./proposition.js";
10
12
  export * from "./search.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,2BAA2B,CAAA;AACzC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,2BAA2B,CAAA;AACzC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}
@@ -5,6 +5,8 @@ export * from "./category.js";
5
5
  export * from "./checkout-summary.js";
6
6
  export * from "./delivery-destination.js";
7
7
  export * from "./money.js";
8
+ export * from "./order-details.js";
9
+ export * from "./order-history.js";
8
10
  export * from "./product.js";
9
11
  export * from "./proposition.js";
10
12
  export * from "./search.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,2BAA2B,CAAA;AACzC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,2BAA2B,CAAA;AACzC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}