@checkstack/scripts 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @checkstack/scripts
 
+## 0.1.2
+
+### Patch Changes
+
+- 67158e2: Standardize package metadata, unify AJV versions to 8.18.0, and enforce monorepo architecture rules via updated ESLint configuration. This ensures consistent package discovery and runtime dependency safety across the platform.
+
+## 0.1.1
+
+### Patch Changes
+
+- 0b9fc58: Fix workspace:\* protocol resolution in published packages
+
+  Published packages now correctly have resolved dependency versions instead of `workspace:*` references. This is achieved by using `bun publish` which properly resolves workspace protocol references.
+
 ## 0.1.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@checkstack/scripts",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "checkstack": {
+    "type": "tooling"
+  },
   "bin": {
     "checkstack-scripts": "./src/cli.ts"
   },
@@ -9,11 +12,11 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "inquirer": "^8.1.0",
+    "inquirer": "^13.4.1",
     "handlebars": "^4.7.8"
   },
   "devDependencies": {
-    "@checkstack/tsconfig": "workspace:*",
+    "@checkstack/tsconfig": "0.0.3",
     "@types/inquirer": "^8.2.10",
     "@types/handlebars": "^4.1.0",
     "typescript": "^5.0.0"

package/src/templates/backend/package.json.hbs

@@ -1,4 +1,5 @@
 { "name": "@checkstack/{{pluginName}}", "version": "0.0.1",
+"checkstack": { "type": "backend" },
 "description": "{{pluginDescription}}", "type": "module", "exports": { ".": {
 "import": "./src/index.ts" } }, "scripts": { "typecheck": "tsc --noEmit",
 "lint": "bun run lint:code", "lint:code": "eslint . --max-warnings 0", "test":

package/src/templates/backend/src/router.ts.hbs

@@ -1,7 +1,6 @@
 import { implement } from "@orpc/server";
-import { autoAuthMiddleware, type RpcContext } from "@checkstack/backend-api";
+import { autoAuthMiddleware, type RpcContext, type SafeDatabase } from "@checkstack/backend-api";
 import { {{pluginNameCamel}}Contract } from "@checkstack/{{pluginBaseName}}-common";
-import type { NodePgDatabase } from "drizzle-orm/node-postgres";
 import type * as schema from "./schema";
 import { {{pluginNamePascal}}Service } from "./service";
 
@@ -18,7 +17,7 @@ const os = implement({{pluginNameCamel}}Contract)
 export function create{{pluginNamePascal}}Router({
   database,
 }: {
-  database: NodePgDatabase<typeof schema>;
+  database: SafeDatabase<typeof schema>;
 }) {
   const service = new {{pluginNamePascal}}Service(database);
 
@@ -28,7 +27,7 @@ export function create{{pluginNamePascal}}Router({
     }),
 
     getItem: os.getItem.handler(async ({ input }) => {
-      return await service.getItem(input);
+      return await service.getItem(input.id);
     }),
 
     createItem: os.createItem.handler(async ({ input }) => {
@@ -40,7 +39,7 @@ export function create{{pluginNamePascal}}Router({
     }),
 
     deleteItem: os.deleteItem.handler(async ({ input }) => {
-      await service.deleteItem(input);
+      await service.deleteItem(input.id);
     }),
   });
 }

package/src/templates/backend/src/service.ts.hbs

@@ -1,4 +1,4 @@
-import type { NodePgDatabase } from "drizzle-orm/node-postgres";
+import type { SafeDatabase } from "@checkstack/backend-api";
 import { eq } from "drizzle-orm";
 import * as schema from "./schema";
 import { {{pluginNameCamel}}Items } from "./schema";
@@ -8,7 +8,7 @@ import type {
 } from "@checkstack/{{pluginBaseName}}-common";
 
 export class {{pluginNamePascal}}Service {
-  constructor(private readonly database: NodePgDatabase<typeof schema>) {}
+  constructor(private readonly database: SafeDatabase<typeof schema>) {}
 
   async getItems() {
     return await this.database.select().from({{pluginNameCamel}}Items);

package/src/templates/common/package.json.hbs

@@ -1,4 +1,5 @@
 { "name": "@checkstack/{{pluginName}}", "version": "0.0.1",
+"checkstack": { "type": "common" },
 "description": "{{pluginDescription}}", "type": "module", "exports": { ".": {
 "import": "./src/index.ts" } }, "scripts": { "typecheck": "tsc --noEmit",
 "lint": "bun run lint:code", "lint:code": "eslint . --max-warnings 0" },

package/src/templates/common/src/access.ts.hbs

@@ -10,16 +10,15 @@ export const {{pluginNameCamel}}Access = {
    * - read: View {{pluginBaseName}} data (auto-assigned to authenticated users)
    * - manage: Create, update, and delete {{pluginBaseName}} data
    */
-  ...accessPair(
-    "{{pluginBaseName}}",
-    {
-      read: "Read {{pluginBaseName}} data",
-      manage: "Manage {{pluginBaseName}} data",
+  ...accessPair("{{pluginBaseName}}", {
+    read: {
+      description: "Read {{pluginBaseName}} data",
+      isDefault: true, // read is auto-assigned to "users" role
     },
-    {
-      readIsDefault: true, // read is auto-assigned to "users" role
-    }
-  ),
+    manage: {
+      description: "Manage {{pluginBaseName}} data",
+    },
+  }),
 };
 
 /**

package/src/templates/common/src/rpc-contract.ts.hbs

@@ -1,5 +1,4 @@
-import { oc } from "@orpc/contract";
-import { createClientDefinition, type ProcedureMetadata } from "@checkstack/common";
+import { createClientDefinition, proc } from "@checkstack/common";
 import { z } from "zod";
 import {
   {{pluginNamePascal}}ItemSchema,
@@ -9,31 +8,38 @@ import {
 import { {{pluginNameCamel}}Access } from "./access";
 import { pluginMetadata } from "./plugin-metadata";
 
-// Create base builder with ProcedureMetadata support
-// See: https://docs.checkstack.dev/common-plugins#contract-based-auth-enforcement
-const _base = oc.$meta<ProcedureMetadata>({});
-
 export const {{pluginNameCamel}}Contract = {
   // List all items - requires authenticated user with read access
-  getItems: _base
-    .meta({ userType: "user", access: [{{pluginNameCamel}}Access.read] })
-    .output(z.array({{pluginNamePascal}}ItemSchema)),
+  getItems: proc({
+    operationType: "query",
+    userType: "user",
+    access: [{{pluginNameCamel}}Access.read],
+  }).output(z.array({{pluginNamePascal}}ItemSchema)),
 
   // Get single item
-  getItem: _base
-    .meta({ userType: "user", access: [{{pluginNameCamel}}Access.read] })
-    .input(z.string())
+  getItem: proc({
+    operationType: "query",
+    userType: "user",
+    access: [{{pluginNameCamel}}Access.read],
+  })
+    .input(z.object({ id: z.string() }))
     .output({{pluginNamePascal}}ItemSchema),
 
   // Create item
-  createItem: _base
-    .meta({ userType: "user", access: [{{pluginNameCamel}}Access.manage] })
+  createItem: proc({
+    operationType: "mutation",
+    userType: "user",
+    access: [{{pluginNameCamel}}Access.manage],
+  })
     .input(Create{{pluginNamePascal}}ItemSchema)
     .output({{pluginNamePascal}}ItemSchema),
 
   // Update item
-  updateItem: _base
-    .meta({ userType: "user", access: [{{pluginNameCamel}}Access.manage] })
+  updateItem: proc({
+    operationType: "mutation",
+    userType: "user",
+    access: [{{pluginNameCamel}}Access.manage],
+  })
     .input(
       z.object({
         id: z.string(),
@@ -43,17 +49,21 @@ export const {{pluginNameCamel}}Contract = {
     .output({{pluginNamePascal}}ItemSchema),
 
   // Delete item
-  deleteItem: _base
-    .meta({ userType: "user", access: [{{pluginNameCamel}}Access.manage] })
-    .input(z.string())
+  deleteItem: proc({
+    operationType: "mutation",
+    userType: "user",
+    access: [{{pluginNameCamel}}Access.manage],
+  })
+    .input(z.object({ id: z.string() }))
     .output(z.void()),
 };
 
 // Export contract type
 export type {{pluginNamePascal}}Contract = typeof {{pluginNameCamel}}Contract;
 
-// Export client definition for type-safe forPlugin usage
-// Use: const client = rpcApi.forPlugin({{pluginNamePascal}}Api);
+// Export client definition for type-safe usePluginClient usage
+// Frontend: const client = usePluginClient({{pluginNamePascal}}Api);
+// Backend:  const client = rpcClient.forPlugin({{pluginNamePascal}}Api);
 export const {{pluginNamePascal}}Api = createClientDefinition(
   {{pluginNameCamel}}Contract,
   pluginMetadata

package/src/templates/frontend/package.json.hbs

@@ -1,4 +1,5 @@
 { "name": "@checkstack/{{pluginName}}", "version": "0.0.1",
+"checkstack": { "type": "frontend" },
 "description": "{{pluginDescription}}", "type": "module", "exports": { ".": {
 "import": "./src/index.tsx" } }, "scripts": { "typecheck": "tsc --noEmit",
 "lint": "bun run lint:code", "lint:code": "eslint . --max-warnings 0",

package/src/templates/frontend/src/api.ts.hbs

@@ -1,15 +1,9 @@
-import { createApiRef } from "@checkstack/frontend-api";
-import type { InferClient } from "@checkstack/common";
-import { {{pluginNamePascal}}Api } from "@checkstack/{{pluginBaseName}}-common";
-
-// Re-export types for convenience
+// Re-export types from common for convenience
 export type {
   {{pluginNamePascal}}Item,
   Create{{pluginNamePascal}}Item,
   Update{{pluginNamePascal}}Item,
 } from "@checkstack/{{pluginBaseName}}-common";
 
-// {{pluginNamePascal}}ApiClient is the client type inferred from the Api definition
-export type {{pluginNamePascal}}ApiClient = InferClient<typeof {{pluginNamePascal}}Api>;
-
-export const {{pluginNameCamel}}ApiRef = createApiRef<{{pluginNamePascal}}ApiClient>("{{pluginBaseName}}-api");
+// Re-export the Api definition for usePluginClient usage
+export { {{pluginNamePascal}}Api } from "@checkstack/{{pluginBaseName}}-common";

package/src/templates/frontend/src/components/{{pluginNamePascal}}ListPage.tsx.hbs

@@ -1,53 +1,55 @@
-import { useEffect, useState } from "react";
-import { useApi } from "@checkstack/frontend-api";
-import { {{pluginNameCamel}}ApiRef, type {{pluginNamePascal}}Item } from "../api";
-import { Button, Card } from "@checkstack/ui";
+import { usePluginClient } from "@checkstack/frontend-api";
+import { {{pluginNamePascal}}Api } from "@checkstack/{{pluginBaseName}}-common";
+import type { {{pluginNamePascal}}Item } from "../api";
+import { Button, Card, PageLayout } from "@checkstack/ui";
 import { useNavigate } from "react-router-dom";
+import { Boxes } from "lucide-react";
 
 export const {{pluginNamePascal}}ListPage = () => {
-  const api = useApi({{pluginNameCamel}}ApiRef);
+  const client = usePluginClient({{pluginNamePascal}}Api);
   const navigate = useNavigate();
-  const [items, setItems] = useState<{{pluginNamePascal}}Item[]>([]);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<Error>();
 
-  useEffect(() => {
-    api
-      .getItems()
-      .then(setItems)
-      .catch(setError)
-      .finally(() => setLoading(false));
-  }, [api]);
+  // Query for items - automatic loading and error states
+  const { data: items = [], isLoading, error, refetch } = client.getItems.useQuery({});
 
-  const handleDelete = async (id: string) => {
-    try {
-      await api.deleteItem(id);
-      setItems(items.filter((item) => item.id !== id));
-    } catch (error) {
-      console.error("Failed to delete item:", error);
-    }
+  // Delete mutation with refetch on success
+  const deleteMutation = client.deleteItem.useMutation({
+    onSuccess: () => {
+      void refetch();
+    },
+  });
+
+  const handleDelete = (id: string) => {
+    deleteMutation.mutate({ id });
   };
 
-  if (loading) return <div className="p-6">Loading...</div>;
-  if (error) return <div className="p-6 text-red-500">Error: {error.message}</div>;
+  if (error) {
+    return (
+      <PageLayout title="{{pluginNamePascal}}" icon={Boxes}>
+        <div className="text-destructive">Error: {error.message}</div>
+      </PageLayout>
+    );
+  }
 
   return (
-    <div className="p-6">
-      <div className="flex justify-between items-center mb-4">
-        <h1 className="text-2xl font-bold">{{pluginNamePascal}} Items</h1>
+    <PageLayout
+      title="{{pluginNamePascal}}"
+      icon={Boxes}
+      loading={isLoading}
+      actions={
         <Button onClick={() => navigate("/{{pluginBaseName}}/new")}>
           Create Item
         </Button>
-      </div>
-
+      }
+    >
       <div className="grid gap-4">
-        {items.map((item) => (
+        {items.map((item: {{pluginNamePascal}}Item) => (
           <Card key={item.id} className="p-4">
             <div className="flex justify-between items-start">
               <div>
                 <h3 className="font-semibold">{item.name}</h3>
                 {item.description && (
-                  <p className="text-sm text-gray-600">{item.description}</p>
+                  <p className="text-sm text-muted-foreground">{item.description}</p>
                 )}
               </div>
               <div className="flex gap-2">
@@ -62,8 +64,9 @@ export const {{pluginNamePascal}}ListPage = () => {
                   variant="destructive"
                   size="sm"
                   onClick={() => handleDelete(item.id)}
+                  disabled={deleteMutation.isPending}
                 >
-                  Delete
+                  {deleteMutation.isPending ? "Deleting..." : "Delete"}
                 </Button>
               </div>
             </div>
@@ -71,11 +74,11 @@ export const {{pluginNamePascal}}ListPage = () => {
         ))}
 
         {items.length === 0 && (
-          <Card className="p-8 text-center text-gray-500">
+          <Card className="p-8 text-center text-muted-foreground">
             No items yet. Create your first item to get started.
           </Card>
         )}
       </div>
-    </div>
+    </PageLayout>
   );
 };

package/src/templates/frontend/src/index.tsx.hbs

@@ -1,7 +1,6 @@
-import { createFrontendPlugin, rpcApiRef, type ApiRef } from "@checkstack/frontend-api";
-import { {{pluginNameCamel}}ApiRef, type {{pluginNamePascal}}ApiClient } from "./api";
+import { createFrontendPlugin } from "@checkstack/frontend-api";
 import { {{pluginNamePascal}}ListPage } from "./components/{{pluginNamePascal}}ListPage";
-import { {{pluginNameCamel}}Routes, {{pluginNamePascal}}Api, pluginMetadata, {{pluginNameCamel}}Access } from "@checkstack/{{pluginBaseName}}-common";
+import { {{pluginNameCamel}}Routes, pluginMetadata, {{pluginNameCamel}}Access } from "@checkstack/{{pluginBaseName}}-common";
 
 export default createFrontendPlugin({
   metadata: pluginMetadata,
@@ -15,18 +14,6 @@ export default createFrontendPlugin({
       accessRule: {{pluginNameCamel}}Access.read,
     },
   ],
-
-  // Register client API using oRPC
-  apis: [
-    {
-      ref: {{pluginNameCamel}}ApiRef,
-      factory: (deps: { get: <T>(ref: ApiRef<T>) => T }): {{pluginNamePascal}}ApiClient => {
-        const rpcApi = deps.get(rpcApiRef);
-        // Create type-safe client using the plugin's Api definition
-        return rpcApi.forPlugin({{pluginNamePascal}}Api);
-      },
-    },
-  ],
 });
 
 export * from "./api";