@nyc-transit-kit/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nyc-transit-kit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @nyc-transit-kit/cli
+
+Part of `nyc-transit-kit`, an Effect-native Bun toolkit for official NYC and MTA transit data APIs.
+
+See the repository README and docs/api-reference.md for public import paths, CLI commands, and release notes.

package/bin/ntk

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import { main } from "../src/main.ts"
+await main()

package/bin/nyc-transit

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import { main } from "../src/main.ts"
+await main()

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nyc-transit-kit/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "sideEffects": false,
+  "bin": {
+    "ntk": "./bin/ntk",
+    "nyc-transit": "./bin/nyc-transit"
+  },
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "types": "./src/index.ts",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "bin",
+    "scripts",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "test": "bun test ./test"
+  },
+  "dependencies": {
+    "@effect/platform-bun": "4.0.0-beta.83",
+    "@nyc-transit-kit/contracts": "0.1.0",
+    "@nyc-transit-kit/mta": "0.1.0",
+    "@nyc-transit-kit/nyc-dot": "0.1.0",
+    "@nyc-transit-kit/nyc-open-data": "0.1.0",
+    "@nyc-transit-kit/soda3": "0.1.0",
+    "effect": "4.0.0-beta.83"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mannyc2/nyc-transit-kit.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/mannyc2/nyc-transit-kit#readme",
+  "bugs": {
+    "url": "https://github.com/mannyc2/nyc-transit-kit/issues"
+  },
+  "keywords": [
+    "bun",
+    "effect",
+    "mta",
+    "nyc",
+    "socrata",
+    "transit"
+  ],
+  "engines": {
+    "bun": ">=1.3.14"
+  }
+}

package/scripts/build-binary.ts

@@ -0,0 +1,113 @@
+import { mkdir } from "node:fs/promises"
+import { join } from "node:path"
+import { pathToFileURL } from "node:url"
+import { releaseVersion, schemaVersion } from "@nyc-transit-kit/contracts/metadata"
+import { CliReleaseArtifact, CliReleaseManifest } from "@nyc-transit-kit/contracts/release"
+import * as Schema from "effect/Schema"
+
+const binaryPath = "dist/ntk"
+const manifestPath = "dist/ntk-release-manifest.json"
+
+const releasePlatform = () => {
+  switch (process.platform) {
+    case "darwin":
+      return "darwin"
+    case "linux":
+      return "linux"
+    case "win32":
+      return "win32"
+    default:
+      return undefined
+  }
+}
+
+const releaseArchitecture = () => {
+  switch (process.arch) {
+    case "arm64":
+      return "arm64"
+    case "x64":
+      return "x64"
+    default:
+      return undefined
+  }
+}
+
+const currentCommit = () => {
+  const result = Bun.spawnSync(["git", "rev-parse", "HEAD"], {
+    stderr: "pipe",
+    stdout: "pipe"
+  })
+
+  if (!result.success) {
+    return "unknown"
+  }
+
+  return result.stdout.toString().trim()
+}
+
+const sha256 = async (path: string) => {
+  const digest = await crypto.subtle.digest("SHA-256", await Bun.file(path).arrayBuffer())
+  return Array.from(new Uint8Array(digest))
+    .map((byte) => byte.toString(16).padStart(2, "0"))
+    .join("")
+}
+
+await mkdir("dist", { recursive: true })
+
+const platform = releasePlatform()
+const arch = releaseArchitecture()
+
+if (platform === undefined || arch === undefined) {
+  console.error(`Unsupported release target: ${process.platform}/${process.arch}`)
+  process.exit(1)
+}
+
+const commit = currentCommit()
+const buildTarget = `${platform}-${arch}`
+const result = await Bun.build({
+  entrypoints: ["packages/cli/src/main.ts"],
+  define: {
+    "process.env.NTK_BUILD_COMMIT": JSON.stringify(commit),
+    "process.env.NTK_BUILD_TARGET": JSON.stringify(buildTarget)
+  },
+  compile: {
+    outfile: binaryPath
+  }
+})
+
+if (!result.success) {
+  for (const log of result.logs) {
+    console.error(log)
+  }
+  process.exit(1)
+}
+
+const manifest = CliReleaseManifest.make({
+  manifestVersion: 1,
+  packageName: "@nyc-transit-kit/cli",
+  version: releaseVersion,
+  schemaVersion,
+  schemaCommit: commit,
+  generatedSourceCommit: commit,
+  builtAt: new Date().toISOString(),
+  artifacts: [
+    CliReleaseArtifact.make({
+      platform,
+      arch,
+      url: pathToFileURL(join(process.cwd(), binaryPath)).href,
+      sha256: await sha256(binaryPath),
+      size: Bun.file(binaryPath).size,
+      signed: false
+    })
+  ]
+})
+
+if (!Schema.is(CliReleaseManifest)(manifest)) {
+  console.error("Generated CLI release manifest failed schema validation.")
+  process.exit(1)
+}
+
+await Bun.write(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`)
+
+console.log(`Built ${binaryPath}`)
+console.log(`Wrote ${manifestPath}`)

package/scripts/build.ts

@@ -0,0 +1 @@
+console.log("CLI build plan is scaffolded. Binary build implementation is deferred.")

package/src/build-info.ts

@@ -0,0 +1,2 @@
+export const buildCommit = process.env.NTK_BUILD_COMMIT ?? "unknown"
+export const buildTarget = process.env.NTK_BUILD_TARGET ?? "source"

package/src/commands/catalog.ts

@@ -0,0 +1,59 @@
+import { buildCatalogSearchUrl, catalogSearch } from "@nyc-transit-kit/soda3/catalog"
+import * as Effect from "effect/Effect"
+import * as Command from "effect/unstable/cli/Command"
+import * as Flag from "effect/unstable/cli/Flag"
+import { runEffect, writeSuccess } from "./shared"
+import { CliCommandContext } from "./types"
+
+export const catalogCommandPaths: ReadonlyArray<ReadonlyArray<string>> = [["catalog", "search"]]
+
+export const handleCatalogSearch = (config: {
+  readonly domain: string
+  readonly query: string
+  readonly dryRun: boolean
+}) =>
+  Effect.gen(function* () {
+    const context = yield* CliCommandContext
+    const tokens = ["catalog", "search"]
+    const request = {
+      domain: config.domain,
+      query: config.query
+    }
+    const url = yield* buildCatalogSearchUrl(request)
+
+    if (config.dryRun) {
+      return yield* writeSuccess(context, "socrata", {
+        dryRun: true,
+        method: "GET",
+        url: url.toString()
+      })
+    }
+
+    return yield* runEffect(
+      context,
+      "socrata",
+      tokens,
+      catalogSearch(request).pipe(Effect.provide(context.runtime.soda3Layer))
+    )
+  })
+
+const catalogSearchCommand = Command.make(
+  "search",
+  {
+    domain: Flag.string("domain").pipe(
+      Flag.withDescription("Socrata domain without protocol, such as data.cityofnewyork.us.")
+    ),
+    query: Flag.string("query").pipe(
+      Flag.withDescription("Search text for Socrata Discovery API.")
+    ),
+    dryRun: Flag.boolean("dry-run").pipe(
+      Flag.withDescription("Print the planned request without contacting the provider.")
+    )
+  },
+  handleCatalogSearch
+).pipe(Command.withShortDescription("Search a Socrata catalog."))
+
+export const catalogCommand = Command.make("catalog").pipe(
+  Command.withShortDescription("Socrata catalog commands."),
+  Command.withSubcommands([catalogSearchCommand])
+)