@deterministic-code/migraters 0.0.0-stage → 0.0.2

package/README.md

@@ -1,3 +1 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Migrate executables for deterministic-code.

package/bundle.yaml

@@ -0,0 +1,262 @@
+# Source of truth for vendoring migrate runners into generated apps.
+# generators-migraters `fetch-bundle` copies these files; `generate` emits
+# Bundled content or Reference install instructions from the same manifest.
+
+repository: https://github.com/deterministic-code/migraters
+ref: main
+
+languages:
+  typescript:
+    root: migraters
+    common:
+      - cli.yaml
+      - typescript/cli.yaml
+      - typescript/package.json
+      - typescript/tsconfig.build.json
+      - typescript/src/**/*.ts
+      - shared/templates/help/**
+      - shared/templates/messages/**
+      - shared/templates/scaffold/**
+    exclude:
+      - typescript/src/**/*.test.ts
+      - typescript/src/generate-help.ts
+    dialects:
+      sqlite:
+        files:
+          - typescript/src/dialects/sqlite-dialect.ts
+          - shared/templates/sql/sqlite/**
+        apk: sqlite
+        packages:
+          - name: better-sqlite3
+            version: "^13.0.3"
+            installScripts: true
+      postgres:
+        files:
+          - typescript/src/dialects/postgres-dialect.ts
+          - shared/templates/sql/postgres/**
+        apk: postgresql-client
+        packages:
+          - name: pg
+            version: "^8.13.0"
+      mysql:
+        files:
+          - typescript/src/dialects/mysql-dialect.ts
+          - shared/templates/sql/mysql/**
+        apk: mysql-client
+        packages:
+          - name: mysql2
+            version: "^3.22.2"
+      sqlserver:
+        files:
+          - typescript/src/dialects/sqlserver-dialect.ts
+          - shared/templates/sql/sqlserver/**
+        packages:
+          - name: mssql
+            version: "^12.5.0"
+      oracle:
+        files:
+          - typescript/src/dialects/oracle-dialect.ts
+          - shared/templates/sql/oracle/**
+        packages:
+          - name: oracledb
+            version: "^6.10.0"
+    commands:
+      setup: migrate-setup --provider {{provider}}
+      up: migrate-up --provider {{provider}} --migrate-path {{migrationsPath}}
+      down: migrate-down --provider {{provider}} --migrate-path {{migrationsPath}}
+      create: migrate-create --provider {{provider}}
+    build:
+      cwd: typescript
+      steps:
+        - npm install
+        - npm run build
+    invoke:
+      setup:
+        reference: migrate-setup --provider "$DIALECT" --connection "$CONN"
+        bundled: npm --prefix /app/migraters/typescript exec -- migrate-setup --provider "$DIALECT" --connection "$CONN"
+      up:
+        reference: migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+        bundled: npm --prefix /app/migraters/typescript exec -- migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+    reference:
+      package: "@deterministic-code/migraters"
+      spec: "github:deterministic-code/migraters"
+    docker:
+      copy:
+        reference: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+        bundled: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+          COPY {{lane}}migraters ./migraters
+      runtime_copy:
+        reference: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+        bundled: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+          COPY {{lane}}migraters ./migraters
+
+  rust:
+    root: migraters
+    common:
+      - rust/Cargo.toml
+      - rust/rustfmt.toml
+      - rust/src/**/*.rs
+      - rust/init/**
+      - shared/templates/help/**
+      - shared/templates/messages/**
+      - shared/templates/scaffold/**
+      - cli.yaml
+    dialects:
+      sqlite:
+        files:
+          - rust/src/dialects/sqlite.rs
+          - shared/templates/sql/sqlite/**
+        apk: sqlite
+        feature: sqlite
+      postgres:
+        files:
+          - rust/src/dialects/postgres.rs
+          - shared/templates/sql/postgres/**
+        apk: postgresql-client
+        feature: postgres
+      mysql:
+        files:
+          - rust/src/dialects/mysql.rs
+          - shared/templates/sql/mysql/**
+        apk: mysql-client
+        feature: mysql
+      sqlserver:
+        files:
+          - rust/src/dialects/sqlserver.rs
+          - shared/templates/sql/sqlserver/**
+        feature: sqlserver
+      oracle:
+        files:
+          - rust/src/dialects/oracle.rs
+          - shared/templates/sql/oracle/**
+        feature: oracle
+    commands:
+      setup: migrate-setup --provider {{provider}}
+      up: migrate-up --provider {{provider}} --migrate-path {{migrationsPath}}
+      down: migrate-down --provider {{provider}} --migrate-path {{migrationsPath}}
+      create: migrate-create --provider {{provider}}
+    build:
+      cwd: rust
+      steps:
+        - cargo build --release
+    invoke:
+      setup:
+        reference: migrate-setup --provider "$DIALECT" --connection "$CONN"
+        bundled: /app/migraters/rust/target/release/migrate-setup --provider "$DIALECT" --connection "$CONN"
+      up:
+        reference: migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+        bundled: /app/migraters/rust/target/release/migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+    reference:
+      git: "https://github.com/deterministic-code/migraters"
+      path: rust
+    docker:
+      copy:
+        reference: |
+          COPY {{shared}}sql ./sql
+        bundled: |
+          COPY {{shared}}sql ./sql
+          COPY {{lane}}migraters ./migraters
+          RUN cargo build --release --manifest-path migraters/rust/Cargo.toml
+      runtime_copy:
+        reference: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+        bundled: |
+          COPY --from=builder /app/migraters/rust/target/release/migrate-setup /app/migraters/rust/target/release/migrate-setup
+          COPY --from=builder /app/migraters/rust/target/release/migrate-up /app/migraters/rust/target/release/migrate-up
+          COPY --from=builder /app/migraters/rust/target/release/migrate-down /app/migraters/rust/target/release/migrate-down
+          COPY --from=builder /app/migraters/rust/target/release/migrate-create /app/migraters/rust/target/release/migrate-create
+          COPY {{shared}}sql {{containerSqlRoot}}
+
+  csharp:
+    root: migraters
+    common:
+      - csharp/**/*.cs
+      - csharp/MigrateRunner.csproj
+      - csharp/MigrateInit/MigrateInit.csproj
+      - csharp/GlobalUsings.cs
+      - csharp/.csharpierrc.json
+      - csharp/.csharpierignore
+      - csharp/dotnet-tools.json
+      - cli.yaml
+      - shared/templates/help/**
+      - shared/templates/messages/**
+      - shared/templates/scaffold/**
+    exclude:
+      - csharp/bin/**
+      - csharp/obj/**
+    dialects:
+      sqlite:
+        files:
+          - csharp/Dialects/SqliteDialect.cs
+          - shared/templates/sql/sqlite/**
+        apk: sqlite
+        packages:
+          - name: Microsoft.Data.Sqlite
+            version: "9.0.0"
+      postgres:
+        files:
+          - csharp/Dialects/PostgresDialect.cs
+          - shared/templates/sql/postgres/**
+        apk: postgresql-client
+        packages:
+          - name: Npgsql
+            version: "9.0.1"
+      mysql:
+        files:
+          - csharp/Dialects/MysqlDialect.cs
+          - shared/templates/sql/mysql/**
+        apk: mysql-client
+        packages:
+          - name: MySqlConnector
+            version: "2.4.0"
+      sqlserver:
+        files:
+          - csharp/Dialects/SqlServerDialect.cs
+          - shared/templates/sql/sqlserver/**
+        packages:
+          - name: Microsoft.Data.SqlClient
+            version: "6.0.1"
+      oracle:
+        files:
+          - csharp/Dialects/OracleDialect.cs
+          - shared/templates/sql/oracle/**
+        packages:
+          - name: Oracle.ManagedDataAccess.Core
+            version: "23.7.0"
+    commands:
+      setup: migrate-setup --provider {{provider}}
+      up: migrate-up --provider {{provider}} --migrate-path {{migrationsPath}}
+      down: migrate-down --provider {{provider}} --migrate-path {{migrationsPath}}
+      create: migrate-create --provider {{provider}}
+    build:
+      cwd: csharp
+      steps:
+        - dotnet publish MigrateRunner.csproj -c Release
+    invoke:
+      setup:
+        reference: migrate-setup --provider "$DIALECT" --connection "$CONN"
+        bundled: dotnet /app/MigrateRunner/MigrateRunner.dll setup --provider "$DIALECT" --connection "$CONN"
+      up:
+        reference: migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+        bundled: dotnet /app/MigrateRunner/MigrateRunner.dll up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+    reference:
+      git: "https://github.com/deterministic-code/migraters"
+      path: csharp
+    docker:
+      copy:
+        reference: |
+          COPY {{shared}}sql ./sql
+        bundled: |
+          COPY {{shared}}sql ./sql
+          COPY {{lane}}migraters ./migraters
+          RUN dotnet publish migraters/csharp/MigrateRunner.csproj -c Release -o /app/migrate-publish
+      runtime_copy:
+        reference: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+        bundled: |
+          COPY --from=build /app/migrate-publish ./MigrateRunner
+          COPY {{shared}}sql {{containerSqlRoot}}

package/cli.yaml

@@ -0,0 +1,264 @@
+# Source of truth for migrate command names, argv layout, and --help copy.
+# TypeScript, Rust, and C# parsers must match this file.
+# IMigrater (setup, up, down, create) lives in api.yaml. SQL spelling is a provider detail.
+# Help templates in shared/templates/help are generated:
+#   npm run generate:help
+# Usage line for each verb: `Usage: migrate-<verb> ` + args in order.
+
+command: migrate-{verb}
+
+providers:
+  - sqlite
+  - postgres
+  - mysql
+  - sqlserver
+  - oracle
+
+# Lookup: lowercase, strip spaces/underscores/hyphens, then match a provider or alias.
+provider_aliases:
+  sqlite3: sqlite
+  mariadb: mysql
+  postgresql: postgres
+  pg: postgres
+  mssql: sqlserver
+  mssqlserver: sqlserver
+  ora: oracle
+
+exit_codes:
+  success: 0
+  usage: 2
+  runtime: 1
+
+help:
+  - -h
+  - --help
+
+help_stream: stderr
+
+# Canonical argv is `--flag value`. `--flag=value` is optional extra syntax.
+aliases:
+  --migrate-path: --migrations-path
+  --migrate-root: --migrations-root
+
+env_var_list_separator: " / "
+
+migrations:
+  path_flag: --migrations-path
+  root_flag: --migrations-root
+  root_default: sql
+  layout: "<root>/<provider>/migrations"
+  discovery: top_level_up_down_pairs
+  missing_directory: errors/migrate-path-not-dir
+
+create:
+  name_pattern: "^[a-z][a-z0-9_]*$"
+  sequence_digits: 4
+
+checksum:
+  algorithm: sha256
+  drift_bypass: MIGRATE_ALLOW_CHECKSUM_DRIFT
+
+# Documented when a command sets show_connection_env: true.
+connection_environment:
+  sqlite: [SQLITE_PATH, DB_PATH]
+  postgres: [PG_CONNECTION_STRING, DATABASE_URL]
+  mysql: [MYSQL_URL, DATABASE_URL]
+  sqlserver: [MSSQL_URL, DATABASE_URL]
+  oracle: [ORACLE_CONNECT_STRING, DATABASE_URL]
+
+commands:
+  - verb: init
+    summary: |
+      Selects the dialects this tree will compile and install. Repeat --dialect
+      once per provider. Re-running replaces the previous set. --all restores
+      every dialect. Does not take --connection.
+    examples: |
+      {{command}} --dialect sqlite --dialect postgres
+      {{command}} --dialect oracle
+      {{command}} --all
+    args:
+      - flag: --dialect
+        placeholder: providers
+        required: false
+        help: "Dialect to enable. Repeat for each dialect. Aliases from this file apply."
+      - flag: --all
+        required: false
+        help: "Enable every dialect. Restores the committed full-provider set."
+
+  - verb: setup
+    show_connection_env: true
+    summary: |
+      Creates the bookkeeping tables (migrates, migrate_logs) for the chosen dialect
+      and the migrations directory (mkdir -p). Idempotent — re-running against an
+      already-setup database is a no-op. For sqlite, also mkdir -p of the parent
+      directory of --connection so a fresh-tree path like ./.test/foo.sqlite works.
+    examples: |
+      # sqlite — bare path or sqlite:// URL; both create a file on disk.
+      {{command}} --provider sqlite --connection ./app.sqlite
+      {{command}} --provider sqlite --connection sqlite:///absolute/path/app.sqlite
+
+      # postgres — URL or keyword form.
+      {{command}} --provider postgres --connection postgresql://user:pass@host:5432/dbname
+
+      # mysql — URL form.
+      {{command}} --provider mysql --connection mysql://user:pass@host:3306/dbname
+
+      # sqlserver / oracle — pass a driver-native connection string.
+      {{command}} --provider sqlserver --connection "Server=host;Database=dbname;User Id=user;Password=pass;"
+      {{command}} --provider oracle   --connection "user/pass@host:1521/service"
+
+      # env-var fallback when --connection is omitted:
+      SQLITE_PATH=./app.sqlite       {{command}} --provider sqlite
+      DATABASE_URL=postgresql://...  {{command}} --provider postgres
+      DATABASE_URL=mysql://...       {{command}} --provider mysql
+
+      # explicit in-memory sqlite:
+      {{command}} --provider sqlite --connection :memory:
+    args:
+      - flag: --provider
+        placeholder: providers
+        required: true
+        help: "Database dialect. Required."
+      - flag: --connection
+        placeholder: url
+        required: true
+        help: "Connection string. Required (or set the per-dialect env var below)."
+      - flag: --migrations-path
+        placeholder: dir
+        required: false
+        help: "Migrations directory (default: ./sql/<dialect>/migrations)."
+      - flag: --and-up
+        required: false
+        help: "After setup, immediately invoke migrate-up so the chain is applied in one step."
+
+  - verb: up
+    show_connection_env: true
+    summary: |
+      Applies ALL pending migrations in sequence, each in its own transaction.
+    examples: |
+      # sqlite — bare path or sqlite:// URL; both create a file on disk.
+      {{command}} --provider sqlite --connection ./app.sqlite
+      {{command}} --provider sqlite --connection sqlite:///absolute/path/app.sqlite
+
+      # postgres — URL or keyword form.
+      {{command}} --provider postgres --connection postgresql://user:pass@host:5432/dbname
+
+      # mysql — URL form.
+      {{command}} --provider mysql --connection mysql://user:pass@host:3306/dbname
+
+      # sqlserver / oracle — pass a driver-native connection string.
+      {{command}} --provider sqlserver --connection "Server=host;Database=dbname;User Id=user;Password=pass;"
+      {{command}} --provider oracle   --connection "user/pass@host:1521/service"
+
+      # env-var fallback when --connection is omitted:
+      SQLITE_PATH=./app.sqlite       {{command}} --provider sqlite
+      DATABASE_URL=postgresql://...  {{command}} --provider postgres
+
+      # custom migrations layout (default looks under sql/<dialect>/migrations):
+      {{command}} --provider sqlite --connection ./app.sqlite --migrations-path ./db/changes/sqlite
+      {{command}} --provider sqlite --connection ./app.sqlite --migrations-root ./db/changes
+
+      # one-shot: apply the next pending migration only, then exit.
+      {{command}} --provider sqlite --connection ./app.sqlite --one
+    args:
+      - flag: --provider
+        placeholder: providers
+        required: true
+        help: "Database dialect. Required."
+      - flag: --connection
+        placeholder: url
+        required: true
+        help: "Connection string. Required (or set the per-dialect env var below)."
+      - flag: --migrations-path
+        placeholder: dir
+        required: false
+        help: "Full path to the migrations directory (e.g. sql/sqlite/migrations)."
+      - flag: --migrations-root
+        placeholder: dir
+        required: false
+        help: |
+          Root prefix; the script then looks at <migrations-root>/<dialect>/migrations.
+          Defaults to 'sql'. Ignored when --migrations-path is also set.
+      - flag: --one
+        required: false
+        help: "Apply only the next pending migration, then exit. Default is to apply all pending migrations."
+
+  - verb: down
+    show_connection_env: true
+    summary: |
+      Rolls back the MOST RECENTLY applied migration (one step). DESTRUCTIVE: prints a
+      random 4-letter uppercase token on stderr and refuses to proceed unless the
+      operator types it back on stdin (or passes --confirm <TOKEN> matching it).
+    examples: |
+      # sqlite — bare path or sqlite:// URL.
+      {{command}} --provider sqlite --connection ./app.sqlite
+      {{command}} --provider sqlite --connection sqlite:///absolute/path/app.sqlite
+
+      # postgres — URL or keyword form.
+      {{command}} --provider postgres --connection postgresql://user:pass@host:5432/dbname
+
+      # mysql — URL form.
+      {{command}} --provider mysql --connection mysql://user:pass@host:3306/dbname
+
+      # sqlserver / oracle — pass a driver-native connection string.
+      {{command}} --provider sqlserver --connection "Server=host;Database=dbname;User Id=user;Password=pass;"
+      {{command}} --provider oracle   --connection "user/pass@host:1521/service"
+
+      # env-var fallback when --connection is omitted:
+      SQLITE_PATH=./app.sqlite       {{command}} --provider sqlite
+      DATABASE_URL=postgresql://...  {{command}} --provider postgres
+
+      # custom migrations layout (default looks under sql/<dialect>/migrations):
+      {{command}} --provider sqlite --connection ./app.sqlite --migrations-path ./db/changes/sqlite
+    args:
+      - flag: --provider
+        placeholder: providers
+        required: true
+        help: "Database dialect. Required."
+      - flag: --connection
+        placeholder: url
+        required: true
+        help: "Connection string. Required (or set the per-dialect env var below)."
+      - flag: --migrations-path
+        placeholder: dir
+        required: false
+        help: "Full path to the migrations directory."
+      - flag: --migrations-root
+        placeholder: dir
+        required: false
+        help: |
+          Root prefix; the script then looks at <migrations-root>/<dialect>/migrations.
+          Defaults to 'sql'. Ignored when --migrations-path is also set.
+      - flag: --confirm
+        placeholder: TOKEN
+        required: false
+        help: |
+          Skip the interactive prompt. The TOKEN must match the value
+          printed on stderr at runtime — there is no fixed bypass value.
+
+  - verb: create
+    summary: |
+      Creates a new <NNNN>_<name>_up.sql + <NNNN>_<name>_down.sql pair scaffolded
+      with TODO placeholders. NNNN is one greater than the highest 1-4-digit
+      sequence prefix already present in the migrations directory (starts at 0001).
+      Legacy timestamp-prefixed filenames are ignored for numbering.
+    examples: |
+      {{command}} --provider sqlite --name add_users
+      {{command}} --provider postgres --name backfill_email_lower --migrations-path ./db/changes/postgres
+    args:
+      - flag: --provider
+        placeholder: providers
+        required: true
+        help: "Database dialect. Required."
+      - flag: --name
+        placeholder: snake_case_slug
+        required: true
+        help: |
+          snake_case slug for the new migration. Required. Must
+          match /^[a-z][a-z0-9_]*$/.
+      - flag: --migrations-path
+        placeholder: dir
+        required: false
+        help: |
+          Migrations directory (default: ./sql/<dialect>/migrations).
+          Created with mkdir -p if it does not exist.

package/dist/abstractions/migrater.d.ts

@@ -0,0 +1,28 @@
+export type SetupArg = {
+    connection: string;
+    migrationsPath: string;
+};
+export type UpArg = {
+    connection: string;
+    migrationsPath: string;
+    one?: boolean;
+};
+export type DownArg = {
+    connection: string;
+    migrationsPath: string;
+};
+export type CreateArg = {
+    name: string;
+    migrationsPath: string;
+};
+export type CreateResponse = {
+    upName: string;
+    downName: string;
+};
+export interface IMigrater {
+    readonly name: string;
+    setup(args: SetupArg): Promise<void>;
+    up(args: UpArg): Promise<string[]>;
+    down(args: DownArg): Promise<string | null>;
+    create(args: CreateArg): Promise<CreateResponse>;
+}

package/dist/abstractions/migrater.js

@@ -0,0 +1 @@
+export {};

package/dist/abstractions/sql-dialect-base.d.ts

@@ -0,0 +1,16 @@
+import type { SqlDialect } from '../sql.ts';
+import type { ISqlDialect } from './sql-dialect.ts';
+export declare abstract class SqlDialectBase implements ISqlDialect {
+    abstract readonly name: SqlDialect;
+    abstract readonly connectionEnvironmentVariables: readonly string[];
+    abstract readonly migratesDdl: string;
+    abstract readonly migrateLogsDdl: string;
+    readonly usesLastInsertRowid: boolean;
+    quoteIdent(ident: string): string;
+    nowExpr(): string;
+    limitClause(n: number): string;
+    translatePlaceholders(sql: string): string;
+    prerequisiteError(_connection: string): Promise<string | null>;
+    prepareSetup(_connection: string): Promise<void>;
+    abstract createClient(connection: string): Promise<import('../migration-client.ts').MigrationClient>;
+}

package/dist/abstractions/sql-dialect-base.js

@@ -0,0 +1,19 @@
+export class SqlDialectBase {
+    usesLastInsertRowid = false;
+    quoteIdent(ident) {
+        return `"${ident}"`;
+    }
+    nowExpr() {
+        return 'CURRENT_TIMESTAMP';
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    translatePlaceholders(sql) {
+        return sql;
+    }
+    async prerequisiteError(_connection) {
+        return null;
+    }
+    async prepareSetup(_connection) { }
+}

package/dist/abstractions/sql-dialect-factory.d.ts

@@ -0,0 +1,8 @@
+import type { ISqlDialect } from './sql-dialect.ts';
+export declare class SqlDialectFactory {
+    private readonly byName;
+    constructor(dialects: readonly ISqlDialect[]);
+    tryGet(raw: string): ISqlDialect | undefined;
+    get(raw: string): ISqlDialect;
+    all(): readonly ISqlDialect[];
+}

package/dist/abstractions/sql-dialect-factory.js

@@ -0,0 +1,22 @@
+import { normalizeDialect } from "../sql.js";
+const VALID = 'sqlite, mysql, postgres, sqlserver, oracle';
+export class SqlDialectFactory {
+    byName;
+    constructor(dialects) {
+        this.byName = new Map(dialects.map((d) => [d.name, d]));
+    }
+    tryGet(raw) {
+        const key = normalizeDialect(raw);
+        return key ? this.byName.get(key) : undefined;
+    }
+    get(raw) {
+        const dialect = this.tryGet(raw);
+        if (!dialect) {
+            throw new Error(`Unknown SQL dialect "${raw}". Valid: ${VALID}.`);
+        }
+        return dialect;
+    }
+    all() {
+        return [...this.byName.values()];
+    }
+}

package/dist/abstractions/sql-dialect.d.ts

@@ -0,0 +1,16 @@
+import type { MigrationClient } from '../migration-client.ts';
+import type { SqlDialect } from '../sql.ts';
+export interface ISqlDialect {
+    readonly name: SqlDialect;
+    readonly connectionEnvironmentVariables: readonly string[];
+    readonly migratesDdl: string;
+    readonly migrateLogsDdl: string;
+    readonly usesLastInsertRowid: boolean;
+    quoteIdent(ident: string): string;
+    nowExpr(): string;
+    limitClause(n: number): string;
+    translatePlaceholders(sql: string): string;
+    prerequisiteError(connection: string): Promise<string | null>;
+    prepareSetup(connection: string): Promise<void>;
+    createClient(connection: string): Promise<MigrationClient>;
+}

package/dist/abstractions/sql-dialect.js

@@ -0,0 +1 @@
+export {};

package/dist/bin/migrate-create.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};