@sequenceholdings/orm 0.1.2 → 2.0.0

package/src/codegen-gql/preset.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+const { createRequire } = require('node:module');
+const path = require('node:path');
+
+const apolloHooksPlugin = require('./apollo-hooks.cjs');
+const serverFnsPlugin = require('./server-fns.cjs');
+
+const CLIENT_PLUGIN = '@sequenceholdings/orm/codegen/apollo-hooks';
+const SERVER_PLUGIN = '@sequenceholdings/orm/codegen/server-fns';
+
+function outputPlugins({ plugin, config }) {
+  return [
+    { typescript: {} },
+    { 'typescript-operations': {} },
+    { 'typed-document-node': {} },
+    { [plugin]: config },
+  ];
+}
+
+function consumerRequireFrom(options) {
+  const cwd = options?.config?.cwd ?? process.cwd();
+  return createRequire(path.join(cwd, 'package.json'));
+}
+
+function createPreset({ loadPlugin } = {}) {
+  return {
+    buildGeneratesSection: async (options) => {
+      const resolvePlugin = loadPlugin ?? ((name) => consumerRequireFrom(options)(name));
+      const pluginMap = {
+        ...options.pluginMap,
+        typescript: resolvePlugin('@graphql-codegen/typescript'),
+        'typescript-operations': resolvePlugin('@graphql-codegen/typescript-operations'),
+        'typed-document-node': resolvePlugin('@graphql-codegen/typed-document-node'),
+        [CLIENT_PLUGIN]: apolloHooksPlugin,
+        [SERVER_PLUGIN]: serverFnsPlugin,
+      };
+
+      return [
+        {
+          filename: `${options.baseOutputDir}client.ts`,
+          plugins: outputPlugins({ plugin: CLIENT_PLUGIN, config: {} }),
+          pluginMap,
+          schema: options.schema,
+          config: options.config,
+          documents: options.documents,
+          documentTransforms: options.documentTransforms,
+        },
+        {
+          filename: `${options.baseOutputDir}server.ts`,
+          plugins: outputPlugins({ plugin: SERVER_PLUGIN, config: { typesImportPath: false } }),
+          pluginMap,
+          schema: options.schema,
+          config: options.config,
+          documents: options.documents,
+          documentTransforms: options.documentTransforms,
+        },
+      ];
+    },
+  };
+}
+
+module.exports = createPreset();
+module.exports.createPreset = createPreset;

package/src/codegen-gql/server-fns.cjs

@@ -16,7 +16,8 @@
  * config:
  *   typesImportPath — module the `<Name><Kind>Variables` types are imported
  *   from (default './types.gen'). Point it at the file the `typescript` +
- *   `typescript-operations` plugins write.
+ *   `typescript-operations` plugins write. Set false when those plugins run
+ *   in the same output file.
  */
 
 function getResultFieldName(operation) {
@@ -60,7 +61,9 @@ function capitalize(str) {
 
 module.exports = {
   plugin: (_schema, documents, config) => {
-    const typesImportPath = (config && config.typesImportPath) || './types.gen';
+    const typesImportPath = config?.typesImportPath === false
+      ? false
+      : (config?.typesImportPath || './types.gen');
     const imports = new Set();
     const functions = documents
       .flatMap(({ document }) => {
@@ -90,10 +93,12 @@ module.exports = {
       .filter(Boolean);
 
     if (functions.length) {
-      const importStatements = [
-        `import { executeOperation } from '@sequenceholdings/orm/client';`,
-        `import { ${Array.from(imports).join(', ')} } from '${typesImportPath}';`,
-      ];
+      const importStatements = [`import { executeOperation } from '@sequenceholdings/orm/client';`];
+      if (typesImportPath) {
+        importStatements.push(
+          `import { ${Array.from(imports).join(', ')} } from '${typesImportPath}';`,
+        );
+      }
       return [...importStatements, ...functions].join('\n\n');
     }
     return '';

package/templates/orm-namespace/CLAUDE.md

@@ -29,11 +29,12 @@ applies it. Your app never talks to Postgres — it calls the data plane with
   GraphQL document in `graphql/`, compiled at push time. For genuinely exotic
   multi-statement writes, declare a table `action` — parameterized, gated,
   audited.
-- **Every table needs `read` and `write` policies.** Policies are the row
-  security boundary and are compiled into every operation touching the table.
-  There is no "no policy" fallback — an unrestricted table must say so
-  explicitly (`allow: true` variant or a `true` policy) so the decision is
-  reviewable.
+- **Every table needs row policies.** At minimum declare `read` plus either a
+  legacy `write` policy or split `insert` / `update` policies when create and
+  resolve are different actors. Policies are the row security boundary and are
+  compiled into every operation touching the table. There is no "no policy"
+  fallback — an unrestricted table must say so explicitly (`allow: true`
+  variant or a `true` policy) so the decision is reviewable.
 - **Exactly one `defineNamespace`** (in `sequence.config.ts`), and every
   table module must call `defineTable` at import time — the CLI collects
   registrations by importing your files.

package/templates/orm-namespace/codegen.preset.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+const { createRequire } = require('node:module');
+const path = require('node:path');
+
+/**
+ * Consumer-local graphql-codegen preset shim. The ORM package ships the preset
+ * implementation, but graphql-codegen plugins must resolve from the scaffold's
+ * devDependencies (pnpm's strict layout does not hoist them into the ORM pkg).
+ */
+const consumerRequire = createRequire(path.join(__dirname, 'package.json'));
+const ormCodegenDir = path.dirname(
+  consumerRequire.resolve('@sequenceholdings/orm/codegen/apollo-hooks'),
+);
+const { createPreset } = require(path.join(ormCodegenDir, 'preset.cjs'));
+
+module.exports = createPreset();

package/templates/orm-namespace/codegen.ts

@@ -14,7 +14,7 @@ const config: CodegenConfig = {
   documents: ['graphql/**/*.ts'],
   generates: {
     './generated/': {
-      preset: '@sequenceholdings/orm/codegen',
+      preset: './codegen.preset.cjs',
     },
   },
 }

package/templates/orm-namespace/package.json

@@ -16,6 +16,9 @@
   },
   "devDependencies": {
     "@graphql-codegen/cli": "^5.0.7",
+    "@graphql-codegen/typed-document-node": "^5.1.1",
+    "@graphql-codegen/typescript": "^4.1.6",
+    "@graphql-codegen/typescript-operations": "^4.6.1",
     "typescript": "^5.6.0"
   },
   "engines": {

package/templates/orm-namespace/schema/tables.ts

@@ -1,4 +1,4 @@
-import { defineEnum, defineTable, t, toMany, toOne, toPlatformUser } from '@sequenceholdings/orm'
+import { defineEnum, defineTable, t, toMany, toOne, toPlatformUser } from '@sequenceholdings/orm/authoring'
 
 /**
  * Tables are TypeScript, but they SERIALIZE to data — the server never runs

package/templates/orm-namespace/sequence.config.ts

@@ -1,4 +1,4 @@
-import { defineNamespace } from '@sequenceholdings/orm'
+import { defineNamespace } from '@sequenceholdings/orm/authoring'
 
 /**
  * The namespace config — exactly one per directory.