@01.software/init 0.10.0 → 0.10.1

package/dist/create-app-templates/ecommerce/tests/domain.test.ts

@@ -247,6 +247,42 @@ test('parseCheckoutPayload rejects invalid customer and shipping fields', () =>
   )
 })
 
+test('parseCheckoutPayload accepts missing shipping fields when the cart requires no shipping', () => {
+  assert.deepEqual(
+    parseCheckoutPayload(
+      {
+        customerSnapshot: {
+          name: 'Ada',
+          email: 'ada@example.test',
+          phone: '010',
+        },
+      },
+      { requiresShipping: false },
+    ),
+    {
+      customerSnapshot: {
+        name: 'Ada',
+        email: 'ada@example.test',
+        phone: '010',
+      },
+    },
+  )
+})
+
+test('parseCheckoutPayload still requires shipping fields by default', () => {
+  assert.throws(
+    () =>
+      parseCheckoutPayload({
+        customerSnapshot: {
+          name: 'Ada',
+          email: 'ada@example.test',
+          phone: '010',
+        },
+      }),
+    /shippingAddress/,
+  )
+})
+
 test('startCheckout converts the server cart then requests payment with the cart total', async () => {
   const order = makePendingOrder({ totalAmount: 99000 })
   let requestedAmount = 0
@@ -333,13 +369,18 @@ test('startCheckout surfaces a failed payment request', async () => {
 
 test('checkout error status preserves SDK authorization failures', () => {
   assert.equal(
-    getCheckoutErrorStatus(Object.assign(new Error('Forbidden'), { status: 403 })),
+    getCheckoutErrorStatus(
+      Object.assign(new Error('Forbidden'), { status: 403 }),
+    ),
     403,
   )
 })
 
 test('checkout error status maps payload validation failures to bad request', () => {
-  assert.equal(getCheckoutErrorStatus(new Error('valid email is required')), 400)
+  assert.equal(
+    getCheckoutErrorStatus(new Error('valid email is required')),
+    400,
+  )
 })
 
 test('mock payment provider stores payments independently from mock commerce orders', async () => {
@@ -369,6 +410,60 @@ test('mock payment provider stores payments independently from mock commerce ord
   clearMockPaymentStore()
 })
 
+test('README documents the server-cart architecture, not removed local stores', async () => {
+  const readFile = await import('node:fs/promises')
+  const readme = await readFile.readFile(
+    new URL('../README.md', import.meta.url),
+    'utf8',
+  )
+
+  assert.match(readme, /Server-authoritative cart/i)
+  assert.match(readme, /commerce\.cart\.\*/)
+  assert.match(readme, /HttpOnly cart cookie/i)
+  assert.match(readme, /cartToken/)
+  assert.match(
+    readme,
+    /client\s+JavaScript receives rendered cart views but never owns the authoritative cart\s+or token/i,
+  )
+  assert.match(
+    readme,
+    /no cart contents are persisted in localStorage/i,
+  )
+  assert.match(readme, /orders\.checkout\(\{ cartId \}\)/)
+  assert.match(readme, /orders\.getByPaymentId/i)
+  assert.match(
+    readme,
+    /mock adapter emulates the server cart and checkout flow in memory/i,
+  )
+  assert.match(readme, /zero-backend demos/i)
+  assert.match(readme, /\/api\/checkout\/payment-return/)
+  assert.match(readme, /tampered redirect amount/i)
+  assert.match(readme, /PG-verified amount/i)
+  assert.match(readme, /Success-page\s+reconciliation/i)
+  assert.match(readme, /orders\.confirmPayment/i)
+  const removedLocalCartText = new RegExp(
+    ['Local persisted cart', ' with Zustand'].join(' state'),
+    'i',
+  )
+  const removedMockOrderIndex = new RegExp(
+    ['\\.mock', 'orders\\.json'].join('-'),
+    'i',
+  )
+  const removedSoftwareOrderIndex = new RegExp(
+    ['\\.software', 'orders\\.json'].join('-'),
+    'i',
+  )
+  const removedLegacyCheckoutCall = new RegExp(
+    ['orders', 'create'].join('\\.'),
+    'i',
+  )
+
+  assert.doesNotMatch(readme, removedLocalCartText)
+  assert.doesNotMatch(readme, removedMockOrderIndex)
+  assert.doesNotMatch(readme, removedSoftwareOrderIndex)
+  assert.doesNotMatch(readme, removedLegacyCheckoutCall)
+})
+
 test('software adapter maps SDK product detail responses into storefront product detail', () => {
   const detail = mapSoftwareProductDetail({
     product: {
@@ -1028,7 +1123,10 @@ test('software adapter threads the SDK checkout → confirm round-trip', async (
 
   // Before placement, a by-payment lookup 404s and resolves to null.
   assert.equal(
-    await provider.getOrderByPaymentId({ paymentId: 'pay_x', provider: 'mock' }),
+    await provider.getOrderByPaymentId({
+      paymentId: 'pay_x',
+      provider: 'mock',
+    }),
     null,
   )
 
@@ -1050,10 +1148,9 @@ test('software adapter threads the SDK checkout → confirm round-trip', async (
   assert.equal(pending.order.displayStatus, 'pending')
   assert.equal(pending.amount, 53000)
   assert.match(pending.paymentId, /^pay_/)
-  // The buyer address is persisted to the cart before checkout, and checkout is
-  // called with the cart id + generated order number.
-  assert.ok(calls.includes('carts.update:cart_1'))
-  assert.ok(calls.includes(`checkout:cart_1:${orderNumber}`))
+  // The buyer address is passed to checkout with the cart capability token so
+  // Console can persist context and price shipping atomically.
+  assert.ok(calls.includes(`checkout:cart_1:tok_1:04524:${orderNumber}`))
   assert.equal(orderNumbers[0], orderNumber)
 
   // Confirm with the minted payment id + provider-verified amount → placed paid
@@ -1114,10 +1211,6 @@ function makeFakeSdkClient(): {
         async find() {
           return { docs: [] }
         },
-        async update(id) {
-          calls.push(`${slug}.update:${id}`)
-          return {}
-        },
       }),
     },
     commerce: {
@@ -1151,7 +1244,9 @@ function makeFakeSdkClient(): {
       },
       orders: {
         async checkout(params) {
-          calls.push(`checkout:${params.cartId}:${params.orderNumber}`)
+          calls.push(
+            `checkout:${params.cartId}:${params.cartToken}:${params.shippingAddress?.postalCode}:${params.orderNumber}`,
+          )
           orderNumbers.push(params.orderNumber)
           return {
             id: 'ord_pending',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@01.software/init",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Initialize 01.software SDK in your project (Next.js, React, Vanilla JS, Node.js, Edge)",
   "repository": {
     "type": "git",
@@ -32,29 +32,28 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "scripts": {
-    "build": "tsup && node scripts/copy-create-app-templates.mjs",
-    "dev": "tsup --watch",
-    "check-types": "tsc --noEmit",
-    "check-snippets": "tsc --project tsconfig.fixture.json --noEmit",
-    "test": "pnpm run build && node --test tests/**/*.test.mjs",
-    "prepublishOnly": "pnpm run check-types && pnpm run build",
-    "release:dev": "node ../../scripts/publish.js dev init",
-    "release:local": "node ../../scripts/publish.js local init"
-  },
   "dependencies": {
     "picocolors": "^1.1.1",
     "prompts": "^2.4.2"
   },
   "devDependencies": {
-    "@01.software/sdk": "workspace:^",
-    "@types/node": "catalog:node22",
+    "@types/node": "^22.19.18",
     "@types/prompts": "^2.4.9",
-    "tsup": "catalog:",
-    "typescript": "catalog:"
+    "tsup": "^8.5.1",
+    "typescript": "5.7.3",
+    "@01.software/sdk": "^0.43.0"
   },
   "author": "<office@01.works>",
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/copy-create-app-templates.mjs",
+    "dev": "tsup --watch",
+    "check-types": "tsc --noEmit",
+    "check-snippets": "tsc --project tsconfig.fixture.json --noEmit",
+    "test": "pnpm run build && node --test tests/**/*.test.mjs",
+    "release:dev": "node ../../scripts/publish.js dev init",
+    "release:local": "node ../../scripts/publish.js local init"
   }
-}
+}