[新サービス] AWS Blocks（Preview）をローカルとAWS sandboxの両方で試してみた

% npm create @aws-blocks/blocks-app@latest my-todo-app

> npx
> "create-blocks-app" my-todo-app

Creating Blocks app in /Users/ishikawa.satoru/workspaces/cc/blog/20260620-aws-blocks-preview/org/my-todo-app...
Installing dependencies...
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE   package: 'my-todo-app@0.1.0',
npm warn EBADENGINE   required: { node: '>=22.0.0' },
npm warn EBADENGINE   current: { node: 'v20.20.0', npm: '11.11.0' }
npm warn EBADENGINE }

added 307 packages, and audited 345 packages in 28s

56 packages are looking for funding
  run `npm fund` for details

1 low severity vulnerability

To address all issues, run:
  npm audit fix

Run `npm audit` for details.

✓ Blocks app created!

Next steps:
  cd /Users/ishikawa.satoru/workspaces/cc/blog/20260620-aws-blocks-preview/org/my-todo-app
  npm run dev

Then open http://localhost:3000

See README.md for an overview and AGENTS.md for AI agent instructions.

cd my-todo-app/
% npm run dev

> my-todo-app@0.1.0 dev
> tsx watch aws-blocks/scripts/server.ts

Loading backend...
Deploying local resources...
  🔌 Attaching dev server (from @aws-blocks/bb-realtime/ws-server)
📝 Generating client code...
AWS Blocks local server running on http://localhost:3000

  ➜  http://localhost:3000/

import { ApiNamespace, Scope, AuthBasic, DistributedTable, Realtime } from '@aws-blocks/blocks';
import { z } from 'zod';

const scope = new Scope('my-app');

// ─── Auth ────────────────────────────────────────────────────────────────────
const auth = new AuthBasic(scope, 'auth', {
  passwordPolicy: { minLength: 8 },
  crossDomain: process.env.BLOCKS_SANDBOX === 'true',
});
export const authApi = auth.createApi();

// ─── Data ────────────────────────────────────────────────────────────────────
// Zod schema = runtime validation + TypeScript types + DynamoDB table shape.
const todoSchema = z.object({
  userId: z.string(),       // partition key — per-user isolation
  todoId: z.string(),       // sort key — unique within a user
  title: z.string(),
  completed: z.boolean(),
  priority: z.number(),     // 1=high, 2=medium, 3=low
  version: z.number(),      // optimistic locking — incremented on each update
  createdAt: z.number(),
});

const todos = new DistributedTable(scope, 'todos', {
  schema: todoSchema,
  key: { partitionKey: 'userId', sortKey: 'todoId' },
  indexes: {
    // Secondary indexes: query todos sorted by priority or title.
    // The partition key is always userId (per-user isolation), the sort key varies.
    byPriority: { partitionKey: 'userId', sortKey: 'priority' },
    byTitle: { partitionKey: 'userId', sortKey: 'title' },
  },
});

// ─── Realtime ────────────────────────────────────────────────────────────────
const rt = new Realtime(scope, 'live', {
  namespaces: {
    todos: Realtime.namespace(z.object({
      action: z.enum(['created', 'updated', 'deleted']),
      todoId: z.string(),
    })),
  },
});

// ─── API ─────────────────────────────────────────────────────────────────────
export const api = new ApiNamespace(scope, 'api', (context) => ({

  async subscribeTodos() {
    const user = await auth.requireAuth(context);
    return rt.getChannel('todos', user.username);
  },

  async createTodo(title: string, priority: number = 2) {
    const user = await auth.requireAuth(context);
    const todoId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
    const todo = {
      userId: user.username,
      todoId,
      title,
      completed: false,
      priority,
      version: 1,
      createdAt: Date.now(),
    };
    await todos.put(todo);
    await rt.publish('todos', user.username, { action: 'created' as const, todoId });
    return todo;
  },
  :
  :
  /**
   * Toggle todo completion with optimistic locking.
   * Uses `ifFieldEquals` to detect concurrent writes. On conflict,
   * throws ConditionalCheckFailedException — caller should re-read and retry.
   */
  async toggleTodo(todoId: string) {
    const user = await auth.requireAuth(context);
    const todo = await todos.get({ userId: user.username, todoId });
    if (!todo) throw new Error('Todo not found');
    await todos.put(
      { ...todo, completed: !todo.completed, version: todo.version + 1 },
      { ifFieldEquals: { version: todo.version } },
    );
    await rt.publish('todos', user.username, { action: 'updated' as const, todoId });
    return { success: true };
  },
  :
  :
}));

/** Delete all completed todos at once. Returns the number removed. */
async clearCompleted() {
  const user = await auth.requireAuth(context);
  const all = await Array.fromAsync(
    todos.query({ where: { userId: { equals: user.username } } })
  );
  const completed = all.filter((t) => t.completed);
  for (const t of completed) {
    await todos.delete({ userId: user.username, todoId: t.todoId });
    await rt.publish('todos', user.username, { action: 'deleted' as const, todoId: t.todoId });
  }
  return { removed: completed.length };
}

% npm run typecheck

> my-todo-app@0.1.0 typecheck
> tsc --noEmit

% npm run sandbox

> my-todo-app@0.1.0 sandbox
> tsx aws-blocks/scripts/sandbox.ts

🚀 Deploying to AWS...
   (This may take a few minutes on first deploy)
Bundling asset my-todo-app-stack-satoruishikawa-0hwgkl/Handler/Code/Stage...

  ...0747fa0accce45da63222b7fd286365049cf2eb4ac08b7-building/index.js  928.5kb

⚡ Done in 112ms

✨  Synthesis time: 1.68s

(node:9612) Warning: NodeVersionSupportWarning: The AWS SDK for JavaScript (v3)
versions published after the first week of January 2027
will require node >=22. You are running node v20.20.0.

To continue receiving updates to AWS services, bug fixes,
and security updates please upgrade to node >=22.

More information can be found at: https://a.co/c895JFp
(Use `node --trace-warnings ...` to show where the warning was created)
(node:9612) Warning: NodeVersionSupportWarning: The AWS SDK for JavaScript (v3)
versions published after the first week of January 2027
will require node >=22. You are running node v20.20.0.

To continue receiving updates to AWS services, bug fixes,
and security updates please upgrade to node >=22.

More information can be found at: https://a.co/c895JFp
my-todo-app-stack-satoruishikawa-0hwgkl: start: Building my-todo-app-stack-satoruishikawa-0hwgkl Template
my-todo-app-stack-satoruishikawa-0hwgkl: success: Built my-todo-app-stack-satoruishikawa-0hwgkl Template
(node:9612) Warning: NodeVersionSupportWarning: The AWS SDK for JavaScript (v3)
versions published after the first week of January 2027
will require node >=22. You are running node v20.20.0.

To continue receiving updates to AWS services, bug fixes,
and security updates please upgrade to node >=22.

More information can be found at: https://a.co/c895JFp
my-todo-app-stack-satoruishikawa-0hwgkl: start: Publishing my-todo-app-stack-satoruishikawa-0hwgkl Template (current_account-current_region-1ac4c392)
my-todo-app-stack-satoruishikawa-0hwgkl: success: Published my-todo-app-stack-satoruishikawa-0hwgkl Template (current_account-current_region-1ac4c392)
my-todo-app-stack-satoruishikawa-0hwgkl: creating CloudFormation changeset...
Changeset arn:aws:cloudformation:ap-northeast-1:123456789012:changeSet/cdk-deploy-change-set/789b1894-b7c6-44cf-aa5d-6e2c611c840c created and waiting in review for manual execution (--no-execute)
my-todo-app-stack-satoruishikawa-0hwgkl: deploying... [1/1]

 ✅  my-todo-app-stack-satoruishikawa-0hwgkl

✨  Deployment time: 149.97s

Outputs:
my-todo-app-stack-satoruishikawa-0hwgkl.APIEndpoint1793E782 = https://ot0i4m1yxe.execute-api.ap-northeast-1.amazonaws.com/prod/
my-todo-app-stack-satoruishikawa-0hwgkl.ApiUrl = https://ot0i4m1yxe.execute-api.ap-northeast-1.amazonaws.com/prod/aws-blocks/api
my-todo-app-stack-satoruishikawa-0hwgkl.RealtimeWsUrl = wss://dlv30yq2ee.execute-api.ap-northeast-1.amazonaws.com/rt
Stack ARN:
arn:aws:cloudformation:ap-northeast-1:123456789012:stack/my-todo-app-stack-satoruishikawa-0hwgkl/8d314bd0-6c8e-11f1-a765-06d2106e79fd

✨  Total time: 164.86s

✅ Sandbox deployed!
📡 API URL: https://ot0i4m1yxe.execute-api.ap-northeast-1.amazonaws.com/prod/aws-blocks/api
📝 Generating client code...
[Realtime] BLOCKS_RT_WS_URL not set — getChannel() will return incomplete descriptors
(node:10169) Warning: NodeVersionSupportWarning: The AWS SDK for JavaScript (v3)
versions published after the first week of January 2027
will require node >=22. You are running node v20.20.0.
:
:

^C
Shutting down...

Shutting down...

🛑 Stopping local processes...
   (AWS resources are still running)

   To destroy AWS resources, run: npm run sandbox:destroy

19:28:51 [tsx] Previous process hasn't exited yet. Force killing...
19:28:51 [tsx] Previous process hasn't exited yet. Force killing...
%

% npm run sandbox:destroy

> my-todo-app@0.1.0 sandbox:destroy
> tsx -C cdk aws-blocks/scripts/sandbox-destroy.ts

🗑️  Destroying sandbox...
my-todo-app-stack-satoruishikawa-0hwgkl: destroying... [1/1]
(node:16056) Warning: NodeVersionSupportWarning: The AWS SDK for JavaScript (v3)
versions published after the first week of January 2027
will require node >=22. You are running node v20.20.0.

To continue receiving updates to AWS services, bug fixes,
and security updates please upgrade to node >=22.
:
: