@ankhorage/infra 1.1.0 → 2.0.1

package/src/generatedApiDatabase.ts

@@ -0,0 +1,558 @@
+import type {
+  DataContractValue,
+  DbCollectionDefinition,
+  DbFieldDefinition,
+  GeneratedApiDefinition,
+  GeneratedApiRegistry,
+  GeneratedApiResourceDefinition,
+  GeneratedApiSeedRecord,
+} from '@ankhorage/contracts';
+
+import type { GeneratedInfrastructureFile } from './types';
+
+export type GeneratedApiDatabaseDiagnosticCode =
+  | 'duplicate-field'
+  | 'duplicate-resource-id'
+  | 'duplicate-target'
+  | 'invalid-default'
+  | 'invalid-identifier'
+  | 'invalid-primary-key'
+  | 'invalid-seed'
+  | 'registry-id-mismatch'
+  | 'unsupported-policy'
+  | 'unsupported-provider';
+
+export interface GeneratedApiDatabaseDiagnostic {
+  readonly code: GeneratedApiDatabaseDiagnosticCode;
+  readonly severity: 'error' | 'warning';
+  readonly apiId: string;
+  readonly resourceId?: string;
+  readonly path?: string;
+  readonly message: string;
+}
+
+export interface GeneratedApiDatabaseArtifacts {
+  readonly files: readonly GeneratedInfrastructureFile[];
+  readonly diagnostics: readonly GeneratedApiDatabaseDiagnostic[];
+}
+
+interface GeneratedResourceContext {
+  readonly api: GeneratedApiDefinition;
+  readonly resource: GeneratedApiResourceDefinition;
+  readonly seed: readonly GeneratedApiSeedRecord[];
+}
+
+interface GeneratedSeedEntry {
+  readonly apiId: string;
+  readonly resourceId: string;
+  readonly collection: DbCollectionDefinition;
+  readonly records: readonly GeneratedApiSeedRecord[];
+}
+
+const DEFAULT_DATABASE_SCHEMA = 'public';
+const SQL_IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+export function generateGeneratedApiDatabaseArtifacts(args: {
+  readonly generatedApis: GeneratedApiRegistry | undefined;
+  readonly databaseProvider: string | undefined;
+}): GeneratedApiDatabaseArtifacts {
+  const contexts = listGeneratedResources(args.generatedApis);
+  if (contexts.length === 0) return { files: [], diagnostics: [] };
+
+  const diagnostics = validateGeneratedApiDatabaseState(
+    args.generatedApis ?? {},
+    contexts,
+    args.databaseProvider,
+  );
+  if (diagnostics.some((diagnostic) => diagnostic.severity === 'error')) {
+    return { files: [], diagnostics };
+  }
+
+  const seedEntries = contexts.map(createSeedEntry);
+  const metadata = contexts.map((context) => ({
+    apiId: context.api.id,
+    database: context.api.database,
+    auth: context.api.auth ?? null,
+    resourceId: context.resource.id,
+    operations: context.resource.operations,
+    collection: context.resource.collection,
+    policies: context.resource.policies ?? [],
+  }));
+
+  return {
+    files: [
+      jsonFile('infra/minikube/db/generated-api-resources.json', metadata),
+      jsonFile('infra/minikube/db/generated-api-seed.json', seedEntries),
+      {
+        path: 'infra/minikube/db/migrations/001_generated_api_resources.sql',
+        content: generateMigrationSql(contexts),
+      },
+      {
+        path: 'infra/minikube/db/seeds/001_generated_api_seed.sql',
+        content: generateSeedSql(seedEntries),
+      },
+      {
+        path: 'infra/minikube/db/README.md',
+        content: generateReadme(contexts),
+      },
+    ],
+    diagnostics,
+  };
+}
+
+function listGeneratedResources(
+  registry: GeneratedApiRegistry | undefined,
+): readonly GeneratedResourceContext[] {
+  return Object.values(registry ?? {})
+    .sort((left, right) => left.id.localeCompare(right.id))
+    .flatMap((api) =>
+      [...api.resources]
+        .sort((left, right) => left.id.localeCompare(right.id))
+        .map((resource) => ({ api, resource, seed: resource.seed ?? [] })),
+    );
+}
+
+function validateGeneratedApiDatabaseState(
+  registry: GeneratedApiRegistry,
+  contexts: readonly GeneratedResourceContext[],
+  databaseProvider: string | undefined,
+): readonly GeneratedApiDatabaseDiagnostic[] {
+  const diagnostics: GeneratedApiDatabaseDiagnostic[] = [];
+  const targets = new Map<string, GeneratedResourceContext>();
+  const resourceIdsByApi = new Map<string, Set<string>>();
+
+  if (databaseProvider !== 'supabase') {
+    diagnostics.push({
+      code: 'unsupported-provider',
+      severity: 'error',
+      apiId: contexts[0]?.api.id ?? 'generated-api',
+      path: 'infra.database.provider',
+      message: 'Generated API database resources currently require the supabase provider.',
+    });
+  }
+
+  for (const [registryId, api] of Object.entries(registry)) {
+    if (registryId !== api.id) {
+      diagnostics.push({
+        code: 'registry-id-mismatch',
+        severity: 'error',
+        apiId: api.id,
+        path: `generatedApis.${registryId}.id`,
+        message: `Generated API registry key '${registryId}' does not match definition id '${api.id}'.`,
+      });
+    }
+  }
+
+  for (const context of contexts) {
+    const { api, resource } = context;
+    const resourceIds = resourceIdsByApi.get(api.id) ?? new Set<string>();
+    if (resourceIds.has(resource.id)) {
+      diagnostics.push(
+        resourceDiagnostic(
+          context,
+          'duplicate-resource-id',
+          'id',
+          `Resource ID '${resource.id}' is duplicated.`,
+        ),
+      );
+    }
+    resourceIds.add(resource.id);
+    resourceIdsByApi.set(api.id, resourceIds);
+
+    validateIdentifier(context, 'collection.name', resource.collection.name, diagnostics);
+    validateIdentifier(
+      context,
+      'collection.schema',
+      resource.collection.schema ?? DEFAULT_DATABASE_SCHEMA,
+      diagnostics,
+    );
+    validateFields(context, diagnostics);
+    validatePrimaryKey(context, diagnostics);
+    validateSeeds(context, diagnostics);
+
+    const target = `${resource.collection.schema ?? DEFAULT_DATABASE_SCHEMA}.${resource.collection.name}`;
+    const previous = targets.get(target);
+    if (previous !== undefined) {
+      diagnostics.push(
+        resourceDiagnostic(
+          context,
+          'duplicate-target',
+          'collection',
+          `Database target '${target}' is already owned by ${previous.api.id}/${previous.resource.id}.`,
+        ),
+      );
+    } else {
+      targets.set(target, context);
+    }
+
+    if ((resource.policies?.length ?? 0) > 0) {
+      diagnostics.push(
+        resourceDiagnostic(
+          context,
+          'unsupported-policy',
+          'policies',
+          'Policy references enable RLS, but the canonical contract does not yet contain provider-owned SQL policy expressions; no CREATE POLICY statement is emitted.',
+          'warning',
+        ),
+      );
+    }
+  }
+
+  return diagnostics;
+}
+
+function validateFields(
+  context: GeneratedResourceContext,
+  diagnostics: GeneratedApiDatabaseDiagnostic[],
+): void {
+  const fieldNames = new Set<string>();
+  for (const field of context.resource.collection.fields) {
+    validateIdentifier(context, `collection.fields.${field.name}.name`, field.name, diagnostics);
+    if (fieldNames.has(field.name)) {
+      diagnostics.push(
+        resourceDiagnostic(
+          context,
+          'duplicate-field',
+          `collection.fields.${field.name}`,
+          `Field '${field.name}' is duplicated.`,
+        ),
+      );
+    }
+    fieldNames.add(field.name);
+
+    if (!isCompatibleDefault(field)) {
+      diagnostics.push(
+        resourceDiagnostic(
+          context,
+          'invalid-default',
+          `collection.fields.${field.name}.defaultValue`,
+          `Default value for '${field.name}' is incompatible with field type '${field.type}'.`,
+        ),
+      );
+    }
+  }
+}
+
+function validatePrimaryKey(
+  context: GeneratedResourceContext,
+  diagnostics: GeneratedApiDatabaseDiagnostic[],
+): void {
+  const { primaryKey } = context.resource.collection;
+  if (primaryKey === undefined) return;
+
+  validateIdentifier(context, 'collection.primaryKey', primaryKey, diagnostics);
+  if (!context.resource.collection.fields.some((field) => field.name === primaryKey)) {
+    diagnostics.push(
+      resourceDiagnostic(
+        context,
+        'invalid-primary-key',
+        'collection.primaryKey',
+        `Primary key '${primaryKey}' must reference a declared field.`,
+      ),
+    );
+  }
+}
+
+function validateSeeds(
+  context: GeneratedResourceContext,
+  diagnostics: GeneratedApiDatabaseDiagnostic[],
+): void {
+  const fields = new Map(context.resource.collection.fields.map((field) => [field.name, field]));
+  const { primaryKey } = context.resource.collection;
+
+  context.seed.forEach((record, index) => {
+    for (const key of Object.keys(record)) {
+      if (!fields.has(key)) {
+        diagnostics.push(
+          resourceDiagnostic(
+            context,
+            'invalid-seed',
+            `seed.${index}.${key}`,
+            `Seed field '${key}' is not declared by the collection.`,
+          ),
+        );
+      }
+    }
+
+    for (const field of fields.values()) {
+      const value = record[field.name];
+      const generatedUuidPrimaryKey =
+        field.name === primaryKey && field.type === 'uuid' && value === undefined;
+      const requiresNonNullValue = field.required === true || field.name === primaryKey;
+
+      if (value === undefined) {
+        if (requiresNonNullValue && field.defaultValue === undefined && !generatedUuidPrimaryKey) {
+          diagnostics.push(
+            resourceDiagnostic(
+              context,
+              'invalid-seed',
+              `seed.${index}.${field.name}`,
+              `Seed record is missing required field '${field.name}'.`,
+            ),
+          );
+        }
+        continue;
+      }
+
+      if (value === null) {
+        if (requiresNonNullValue) {
+          diagnostics.push(
+            resourceDiagnostic(
+              context,
+              'invalid-seed',
+              `seed.${index}.${field.name}`,
+              `Seed field '${field.name}' cannot be null.`,
+            ),
+          );
+        }
+        continue;
+      }
+
+      if (!isCompatibleFieldValue(field, value)) {
+        diagnostics.push(
+          resourceDiagnostic(
+            context,
+            'invalid-seed',
+            `seed.${index}.${field.name}`,
+            `Seed value for '${field.name}' is incompatible with field type '${field.type}'.`,
+          ),
+        );
+      }
+    }
+  });
+}
+
+function validateIdentifier(
+  context: GeneratedResourceContext,
+  path: string,
+  value: string,
+  diagnostics: GeneratedApiDatabaseDiagnostic[],
+): void {
+  if (SQL_IDENTIFIER_RE.test(value)) return;
+  diagnostics.push(
+    resourceDiagnostic(
+      context,
+      'invalid-identifier',
+      path,
+      `Database identifier '${value}' must match ${SQL_IDENTIFIER_RE.source}.`,
+    ),
+  );
+}
+
+function resourceDiagnostic(
+  context: GeneratedResourceContext,
+  code: GeneratedApiDatabaseDiagnosticCode,
+  path: string,
+  message: string,
+  severity: GeneratedApiDatabaseDiagnostic['severity'] = 'error',
+): GeneratedApiDatabaseDiagnostic {
+  return {
+    code,
+    severity,
+    apiId: context.api.id,
+    resourceId: context.resource.id,
+    path: `generatedApis.${context.api.id}.resources.${context.resource.id}.${path}`,
+    message,
+  };
+}
+
+function isCompatibleDefault(field: DbFieldDefinition): boolean {
+  const value = field.defaultValue;
+  if (value === undefined || value === null) return true;
+  return isCompatibleFieldValue(field, value);
+}
+
+function isCompatibleFieldValue(field: DbFieldDefinition, value: DataContractValue): boolean {
+  switch (field.type) {
+    case 'boolean':
+      return typeof value === 'boolean';
+    case 'number':
+      return typeof value === 'number' && Number.isFinite(value);
+    case 'text':
+      return typeof value === 'string';
+    case 'datetime':
+      return typeof value === 'string' && Number.isFinite(Date.parse(value));
+    case 'uuid':
+      return typeof value === 'string' && UUID_RE.test(value);
+    case 'json':
+      return true;
+  }
+}
+
+function createSeedEntry(context: GeneratedResourceContext): GeneratedSeedEntry {
+  return {
+    apiId: context.api.id,
+    resourceId: context.resource.id,
+    collection: context.resource.collection,
+    records: context.seed.map((record, index) => materializeSeedRecord(context, record, index)),
+  };
+}
+
+function materializeSeedRecord(
+  context: GeneratedResourceContext,
+  record: GeneratedApiSeedRecord,
+  index: number,
+): GeneratedApiSeedRecord {
+  const { primaryKey } = context.resource.collection;
+  if (primaryKey === undefined || record[primaryKey] !== undefined) return record;
+
+  const primaryKeyField = context.resource.collection.fields.find(
+    (field) => field.name === primaryKey,
+  );
+  if (primaryKeyField?.type !== 'uuid') return record;
+
+  return {
+    ...record,
+    [primaryKey]: createDeterministicSeedUuid(context.api.id, context.resource.id, index),
+  };
+}
+
+function generateMigrationSql(contexts: readonly GeneratedResourceContext[]): string {
+  const statements = contexts.flatMap((context) => {
+    const schema = quoteIdentifier(context.resource.collection.schema ?? DEFAULT_DATABASE_SCHEMA);
+    const table = quoteIdentifier(context.resource.collection.name);
+    const columns = context.resource.collection.fields.map((field) =>
+      formatColumn(field, field.name === context.resource.collection.primaryKey),
+    );
+    const rls =
+      (context.resource.policies?.length ?? 0) > 0
+        ? [`alter table ${schema}.${table} enable row level security;`]
+        : [];
+
+    return [
+      `create schema if not exists ${schema};`,
+      `create table if not exists ${schema}.${table} (\n  ${columns.join(',\n  ')}\n);`,
+      ...rls,
+    ];
+  });
+
+  return [
+    '-- Generated from canonical GeneratedApiDefinition resources.',
+    '-- No HTTP/GraphQL service or Kubernetes API workload is generated here.',
+    'create extension if not exists pgcrypto;',
+    '',
+    ...statements,
+    '',
+  ].join('\n');
+}
+
+function generateSeedSql(entries: readonly GeneratedSeedEntry[]): string {
+  const statements = entries.flatMap((entry) => createSeedStatements(entry));
+  return [
+    '-- Generated from canonical generated API seed records.',
+    ...(statements.length === 0 ? ['-- No generated API seed records configured.'] : statements),
+    '',
+  ].join('\n');
+}
+
+function createSeedStatements(entry: GeneratedSeedEntry): readonly string[] {
+  if (entry.records.length === 0) return [];
+
+  const fields = entry.collection.fields.filter((field) =>
+    entry.records.some((record) => record[field.name] !== undefined),
+  );
+  if (fields.length === 0) return [];
+
+  const schema = quoteIdentifier(entry.collection.schema ?? DEFAULT_DATABASE_SCHEMA);
+  const table = quoteIdentifier(entry.collection.name);
+  const values = entry.records
+    .map(
+      (record) =>
+        `(${fields.map((field) => formatSeedValue(field, record[field.name])).join(', ')})`,
+    )
+    .join(',\n  ');
+  const conflict =
+    entry.collection.primaryKey === undefined
+      ? 'on conflict do nothing'
+      : `on conflict (${quoteIdentifier(entry.collection.primaryKey)}) do nothing`;
+
+  return [
+    `insert into ${schema}.${table} (${fields.map((field) => quoteIdentifier(field.name)).join(', ')}) values\n  ${values}\n${conflict};`,
+  ];
+}
+
+function formatSeedValue(field: DbFieldDefinition, value: DataContractValue | undefined): string {
+  if (value === undefined) return 'default';
+  return formatFieldValue(field, value);
+}
+
+function formatColumn(field: DbFieldDefinition, primaryKey: boolean): string {
+  const defaultValue = formatDefault(field, primaryKey);
+  const primaryKeyClause = primaryKey ? ' primary key' : '';
+  const required = field.required === true && !primaryKey ? ' not null' : '';
+  const unique = field.unique === true && !primaryKey ? ' unique' : '';
+  return `${quoteIdentifier(field.name)} ${mapFieldType(field.type)}${defaultValue}${primaryKeyClause}${required}${unique}`;
+}
+
+function mapFieldType(type: DbFieldDefinition['type']): string {
+  if (type === 'uuid') return 'uuid';
+  if (type === 'text') return 'text';
+  if (type === 'number') return 'numeric';
+  if (type === 'boolean') return 'boolean';
+  if (type === 'datetime') return 'timestamptz';
+  return 'jsonb';
+}
+
+function formatDefault(field: DbFieldDefinition, primaryKey: boolean): string {
+  if (primaryKey && field.type === 'uuid' && field.defaultValue === undefined) {
+    return ' default gen_random_uuid()';
+  }
+  if (field.defaultValue === undefined) return '';
+  return ` default ${formatFieldValue(field, field.defaultValue)}`;
+}
+
+function formatFieldValue(field: DbFieldDefinition, value: DataContractValue): string {
+  if (value === null) return 'null';
+  if (field.type === 'json') {
+    return `'${escapeString(JSON.stringify(value))}'::jsonb`;
+  }
+  return formatValue(value);
+}
+
+function formatValue(value: DataContractValue): string {
+  if (value === null) return 'null';
+  if (typeof value === 'string') return `'${escapeString(value)}'`;
+  if (typeof value === 'number') return Number.isFinite(value) ? String(value) : 'null';
+  if (typeof value === 'boolean') return value ? 'true' : 'false';
+  return `'${escapeString(JSON.stringify(value))}'::jsonb`;
+}
+
+function generateReadme(contexts: readonly GeneratedResourceContext[]): string {
+  const resources = contexts
+    .map((context) => {
+      const { collection } = context.resource;
+      return `- \`${context.api.id}/${context.resource.id}\` -> \`${collection.schema ?? DEFAULT_DATABASE_SCHEMA}.${collection.name}\``;
+    })
+    .join('\n');
+
+  return `# Generated API Database Artifacts\n\nThese files materialize canonical generated API resources into Supabase/Postgres database infrastructure.\n\n${resources}\n\nNo HTTP/GraphQL server, Docker image, application handler, OpenAPI document, Kubernetes Deployment or Service is generated by this bridge.\n`;
+}
+
+function jsonFile(path: string, value: unknown): GeneratedInfrastructureFile {
+  return { path, content: `${JSON.stringify(value, null, 2)}\n` };
+}
+
+function quoteIdentifier(identifier: string): string {
+  return `"${identifier.replaceAll('"', '""')}"`;
+}
+
+function escapeString(value: string): string {
+  return value.replaceAll("'", "''");
+}
+
+function createDeterministicSeedUuid(apiId: string, resourceId: string, index: number): string {
+  const input = `${apiId}:${resourceId}:${index}`;
+  const hex = `${hashHex(input, 0)}${hashHex(input, 1)}${hashHex(input, 2)}${hashHex(input, 3)}`;
+  const variant = ((Number.parseInt(hex.charAt(16), 16) & 0x3) | 0x8).toString(16);
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(13, 16)}-${variant}${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
+}
+
+function hashHex(input: string, salt: number): string {
+  let hash = 2166136261 ^ salt;
+  for (const char of input) {
+    hash ^= char.charCodeAt(0);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, '0');
+}

package/src/index.ts

@@ -6,8 +6,6 @@ import type {
   InfrastructureGenerationResult,
 } from './types';
 
-export type { ApiInfrastructureArtifacts } from './apiArtifacts';
-export { generateApiInfrastructureArtifacts } from './apiArtifacts';
 export {
   type AuthRedirectConfiguration,
   type AuthRedirectEnvironment,
@@ -16,6 +14,12 @@ export {
   resolveAuthRedirectConfiguration,
   type ResolveAuthRedirectConfigurationInput,
 } from './authRedirects';
+export {
+  type GeneratedApiDatabaseArtifacts,
+  type GeneratedApiDatabaseDiagnostic,
+  type GeneratedApiDatabaseDiagnosticCode,
+  generateGeneratedApiDatabaseArtifacts,
+} from './generatedApiDatabase';
 export {
   createInfraSecretStoreAdapter,
   type CreateInfraSecretStoreAdapterInput,

package/src/project.ts

@@ -1,4 +1,4 @@
-import type { AppManifest, NavigatorSpec } from '@ankhorage/contracts';
+import { APP_CATEGORIES, type AppManifest, type NavigatorSpec } from '@ankhorage/contracts';
 import { promises as fs } from 'fs';
 import path from 'path';
 
@@ -70,6 +70,7 @@ function createFallbackManifest(projectId: string): AppManifest {
       name: projectId,
       slug: projectId,
       version: '0.0.0',
+      category: 'developer_tools',
       themeId: 'default',
     },
     themes: [],
@@ -187,6 +188,7 @@ function isAppManifestMetadata(value: unknown): value is AppManifest['metadata']
     typeof value.name === 'string' &&
     typeof value.slug === 'string' &&
     typeof value.version === 'string' &&
+    APP_CATEGORIES.some((category) => category === value.category) &&
     typeof value.themeId === 'string' &&
     (value.created === undefined || typeof value.created === 'string') &&
     (value.updated === undefined || typeof value.updated === 'string')

package/src/testSupport.ts

@@ -86,6 +86,7 @@ export function createAppManifest(
       name: projectId,
       slug: projectId,
       version: '1.0.0',
+      category: 'developer_tools',
       themeId: 'default',
     },
     themes: [],

package/src/types.ts

@@ -37,7 +37,7 @@ export interface InfrastructureGenerationOptions {
    */
   readonly appManifest?: Pick<
     AppManifest,
-    'data' | 'infra' | 'metadata' | 'navigator' | 'screens' | 'settings'
+    'generatedApis' | 'infra' | 'metadata' | 'navigator' | 'screens' | 'settings'
   >;
 }
 

package/dist/apiArtifacts.d.ts

@@ -1,8 +0,0 @@
-import type { AppDataManifest } from '@ankhorage/contracts';
-import { type ApiInfrastructureArtifacts } from './apis';
-export type { ApiInfrastructureArtifacts } from './apis';
-export declare function generateApiInfrastructureArtifacts(args: {
-    readonly data: AppDataManifest | undefined;
-    readonly databaseProvider: string | undefined;
-}): ApiInfrastructureArtifacts;
-//# sourceMappingURL=apiArtifacts.d.ts.map

package/dist/apiArtifacts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiArtifacts.d.ts","sourceRoot":"","sources":["../src/apiArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,QAAQ,CAAC;AAIhB,YAAY,EAAE,0BAA0B,EAAE,MAAM,QAAQ,CAAC;AAEzD,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C,GAAG,0BAA0B,CAW7B"}

package/dist/apiArtifacts.js

@@ -1,35 +0,0 @@
-import { generateApiInfrastructureArtifacts as generateRawApiInfrastructureArtifacts, } from './apis';
-const GENERATED_API_HANDLERS_PATH = 'src/generated/apis/apiHandlers.ts';
-export function generateApiInfrastructureArtifacts(args) {
-    const artifacts = generateRawApiInfrastructureArtifacts(args);
-    return {
-        ...artifacts,
-        files: artifacts.files.map((file) => file.path === GENERATED_API_HANDLERS_PATH
-            ? { ...file, content: makeGeneratedApiHandlersLintSafe(file.content) }
-            : file),
-    };
-}
-function makeGeneratedApiHandlersLintSafe(source) {
-    let result = source;
-    result = replaceGeneratedSnippet(result, '    async list(apiId: string): Promise<readonly GeneratedApiRecord[]> {', '    list(apiId: string): Promise<readonly GeneratedApiRecord[]> {');
-    result = replaceGeneratedSnippet(result, '      return getRows(records, apiId).map(cloneRecord);', '      return Promise.resolve(getRows(records, apiId).map(cloneRecord));');
-    result = replaceGeneratedSnippet(result, '    async read(apiId: string, id: string): Promise<GeneratedApiRecord | null> {', '    read(apiId: string, id: string): Promise<GeneratedApiRecord | null> {');
-    result = replaceGeneratedSnippet(result, '      if (primaryKey === null) return null;', '      if (primaryKey === null) return Promise.resolve(null);', 3);
-    result = replaceGeneratedSnippet(result, '      return record === undefined ? null : cloneRecord(record);', '      return Promise.resolve(record === undefined ? null : cloneRecord(record));');
-    result = replaceGeneratedSnippet(result, '    async create(apiId: string, values: GeneratedApiRecord): Promise<GeneratedApiRecord> {', '    create(apiId: string, values: GeneratedApiRecord): Promise<GeneratedApiRecord> {');
-    result = replaceGeneratedSnippet(result, '      return cloneRecord(nextRecord);', '      return Promise.resolve(cloneRecord(nextRecord));', 2);
-    result = replaceGeneratedSnippet(result, '    async update(\n', '    update(\n');
-    result = replaceGeneratedSnippet(result, '      if (index < 0) return null;', '      if (index < 0) return Promise.resolve(null);');
-    result = replaceGeneratedSnippet(result, '    async delete(apiId: string, id: string): Promise<GeneratedApiRecord | null> {', '    delete(apiId: string, id: string): Promise<GeneratedApiRecord | null> {');
-    result = replaceGeneratedSnippet(result, '      if (deleted === undefined) return null;', '      if (deleted === undefined) return Promise.resolve(null);');
-    result = replaceGeneratedSnippet(result, '      return cloneRecord(deleted);', '      return Promise.resolve(cloneRecord(deleted));');
-    return result;
-}
-function replaceGeneratedSnippet(source, snippet, replacement, expectedCount = 1) {
-    const count = source.split(snippet).length - 1;
-    if (count !== expectedCount) {
-        throw new Error(`Expected generated API handler snippet ${JSON.stringify(snippet)} ${expectedCount} time(s), found ${count}.`);
-    }
-    return source.replaceAll(snippet, replacement);
-}
-//# sourceMappingURL=apiArtifacts.js.map

package/dist/apiArtifacts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiArtifacts.js","sourceRoot":"","sources":["../src/apiArtifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,kCAAkC,IAAI,qCAAqC,GAC5E,MAAM,QAAQ,CAAC;AAEhB,MAAM,2BAA2B,GAAG,mCAAmC,CAAC;AAIxE,MAAM,UAAU,kCAAkC,CAAC,IAGlD;IACC,MAAM,SAAS,GAAG,qCAAqC,CAAC,IAAI,CAAC,CAAC;IAE9D,OAAO;QACL,GAAG,SAAS;QACZ,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAClC,IAAI,CAAC,IAAI,KAAK,2BAA2B;YACvC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YACtE,CAAC,CAAC,IAAI,CACT;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gCAAgC,CAAC,MAAc;IACtD,IAAI,MAAM,GAAG,MAAM,CAAC;IAEpB,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,yEAAyE,EACzE,mEAAmE,CACpE,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,wDAAwD,EACxD,yEAAyE,CAC1E,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,iFAAiF,EACjF,2EAA2E,CAC5E,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,6CAA6C,EAC7C,8DAA8D,EAC9D,CAAC,CACF,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,iEAAiE,EACjE,kFAAkF,CACnF,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,4FAA4F,EAC5F,sFAAsF,CACvF,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,uCAAuC,EACvC,wDAAwD,EACxD,CAAC,CACF,CAAC;IACF,MAAM,GAAG,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,EAAE,eAAe,CAAC,CAAC;IACjF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,mCAAmC,EACnC,oDAAoD,CACrD,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,mFAAmF,EACnF,6EAA6E,CAC9E,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,+CAA+C,EAC/C,gEAAgE,CACjE,CAAC;IACF,MAAM,GAAG,uBAAuB,CAC9B,MAAM,EACN,oCAAoC,EACpC,qDAAqD,CACtD,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,uBAAuB,CAC9B,MAAc,EACd,OAAe,EACf,WAAmB,EACnB,aAAa,GAAG,CAAC;IAEjB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/C,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,aAAa,mBAAmB,KAAK,GAAG,CAC9G,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACjD,CAAC","sourcesContent":["import type { AppDataManifest } from '@ankhorage/contracts';\n\nimport {\n  type ApiInfrastructureArtifacts,\n  generateApiInfrastructureArtifacts as generateRawApiInfrastructureArtifacts,\n} from './apis';\n\nconst GENERATED_API_HANDLERS_PATH = 'src/generated/apis/apiHandlers.ts';\n\nexport type { ApiInfrastructureArtifacts } from './apis';\n\nexport function generateApiInfrastructureArtifacts(args: {\n  readonly data: AppDataManifest | undefined;\n  readonly databaseProvider: string | undefined;\n}): ApiInfrastructureArtifacts {\n  const artifacts = generateRawApiInfrastructureArtifacts(args);\n\n  return {\n    ...artifacts,\n    files: artifacts.files.map((file) =>\n      file.path === GENERATED_API_HANDLERS_PATH\n        ? { ...file, content: makeGeneratedApiHandlersLintSafe(file.content) }\n        : file,\n    ),\n  };\n}\n\nfunction makeGeneratedApiHandlersLintSafe(source: string): string {\n  let result = source;\n\n  result = replaceGeneratedSnippet(\n    result,\n    '    async list(apiId: string): Promise<readonly GeneratedApiRecord[]> {',\n    '    list(apiId: string): Promise<readonly GeneratedApiRecord[]> {',\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '      return getRows(records, apiId).map(cloneRecord);',\n    '      return Promise.resolve(getRows(records, apiId).map(cloneRecord));',\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '    async read(apiId: string, id: string): Promise<GeneratedApiRecord | null> {',\n    '    read(apiId: string, id: string): Promise<GeneratedApiRecord | null> {',\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '      if (primaryKey === null) return null;',\n    '      if (primaryKey === null) return Promise.resolve(null);',\n    3,\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '      return record === undefined ? null : cloneRecord(record);',\n    '      return Promise.resolve(record === undefined ? null : cloneRecord(record));',\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '    async create(apiId: string, values: GeneratedApiRecord): Promise<GeneratedApiRecord> {',\n    '    create(apiId: string, values: GeneratedApiRecord): Promise<GeneratedApiRecord> {',\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '      return cloneRecord(nextRecord);',\n    '      return Promise.resolve(cloneRecord(nextRecord));',\n    2,\n  );\n  result = replaceGeneratedSnippet(result, '    async update(\\n', '    update(\\n');\n  result = replaceGeneratedSnippet(\n    result,\n    '      if (index < 0) return null;',\n    '      if (index < 0) return Promise.resolve(null);',\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '    async delete(apiId: string, id: string): Promise<GeneratedApiRecord | null> {',\n    '    delete(apiId: string, id: string): Promise<GeneratedApiRecord | null> {',\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '      if (deleted === undefined) return null;',\n    '      if (deleted === undefined) return Promise.resolve(null);',\n  );\n  result = replaceGeneratedSnippet(\n    result,\n    '      return cloneRecord(deleted);',\n    '      return Promise.resolve(cloneRecord(deleted));',\n  );\n\n  return result;\n}\n\nfunction replaceGeneratedSnippet(\n  source: string,\n  snippet: string,\n  replacement: string,\n  expectedCount = 1,\n): string {\n  const count = source.split(snippet).length - 1;\n  if (count !== expectedCount) {\n    throw new Error(\n      `Expected generated API handler snippet ${JSON.stringify(snippet)} ${expectedCount} time(s), found ${count}.`,\n    );\n  }\n\n  return source.replaceAll(snippet, replacement);\n}\n"]}