@firfi/voila-sdk 0.1.2 → 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 (31) hide show
  1. package/README.md +5 -3
  2. package/dist/src/domain/schemas/index.d.ts +1 -0
  3. package/dist/src/domain/schemas/index.d.ts.map +1 -1
  4. package/dist/src/domain/schemas/index.js +1 -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 +237 -60
  11. package/dist/src/domain/schemas/order-history.d.ts.map +1 -1
  12. package/dist/src/domain/schemas/order-history.js +17 -12
  13. package/dist/src/domain/schemas/order-history.js.map +1 -1
  14. package/dist/src/domain/schemas/slot.d.ts +4 -4
  15. package/dist/src/index.d.ts +1 -0
  16. package/dist/src/index.d.ts.map +1 -1
  17. package/dist/src/index.js +1 -0
  18. package/dist/src/index.js.map +1 -1
  19. package/dist/src/voila/order-details.d.ts +22 -0
  20. package/dist/src/voila/order-details.d.ts.map +1 -0
  21. package/dist/src/voila/order-details.js +267 -0
  22. package/dist/src/voila/order-details.js.map +1 -0
  23. package/dist/src/voila/order-history.d.ts +9 -5
  24. package/dist/src/voila/order-history.d.ts.map +1 -1
  25. package/dist/src/voila/order-history.js +23 -5
  26. package/dist/src/voila/order-history.js.map +1 -1
  27. package/dist/src/voila/order-urls.d.ts +10 -0
  28. package/dist/src/voila/order-urls.d.ts.map +1 -1
  29. package/dist/src/voila/order-urls.js +12 -1
  30. package/dist/src/voila/order-urls.js.map +1 -1
  31. package/package.json +1 -1
package/README.md CHANGED
@@ -79,6 +79,8 @@ console.log(search.right.value.products.map((product) => product.name))
79
79
  - Slot listing and guarded slot reservation input helpers.
80
80
  - Checkout summary/readiness review.
81
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?"
82
84
  - Session snapshot save/load helpers.
83
85
 
84
86
  The SDK does not place orders. Checkout APIs stop at review/readiness so a human can confirm in Voila.
@@ -104,7 +106,7 @@ That file is sensitive and ignored by git. Use it with `loadSdkSessionSnapshot`
104
106
  Import only from the package entrypoint:
105
107
 
106
108
  ```ts
107
- import { addCartItems, getCart, getCompletedOrders, searchProducts } from "@firfi/voila-sdk"
109
+ import { addCartItems, getCart, getCompletedOrderItems, getCompletedOrders, getOrderDetails, searchProducts } from "@firfi/voila-sdk"
108
110
  ```
109
111
 
110
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.
@@ -153,9 +155,9 @@ npm publish
153
155
 
154
156
  The package tarball intentionally contains only `package.json`, `README.md`, `LICENSE`, and `dist/src/**`. See [docs/release.md](docs/release.md).
155
157
 
156
- ## Future MCP
158
+ ## MCP And CLI
157
159
 
158
- 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).
159
161
 
160
162
  ## Safety
161
163
 
@@ -5,6 +5,7 @@ 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";
8
9
  export * from "./order-history.js";
9
10
  export * from "./product.js";
10
11
  export * from "./proposition.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,oBAAoB,CAAA;AAClC,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,7 @@ 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";
8
9
  export * from "./order-history.js";
9
10
  export * from "./product.js";
10
11
  export * from "./proposition.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,oBAAoB,CAAA;AAClC,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"}