@kozou/codegen 0.0.1 → 1.0.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,65 @@
 # @kozou/codegen
 
-Placeholder publish. The real experimental release lands via CI shortly.
+> **Experimental.** API and output may change without notice
+> while the package is stabilising.
+
+Kozou's TypeScript codegen. Given a `SchemaContext` (from `@kozou/introspect`
++ `@kozou/core`), it emits one `export interface` per table and view —
+the JSON row shape a client receives from `@kozou/api` — driven entirely by
+your PostgreSQL DDL + `COMMENT` metadata.
+
+This is the compiler-native half of Kozou's type story. It is a pure,
+offline function — no database connection or running API is required to
+generate the row types.
+
+## Scope
+
+Row / entity shapes only. The full API client surface (paths, query
+parameters, request/response envelopes, pagination, embeds) is better served
+by running an OpenAPI generator such as
+[`openapi-typescript`](https://github.com/openapi-ts/openapi-typescript)
+against `@kozou/api`'s `GET /openapi.json`, so this package does **not**
+reimplement that.
+
+## Type mapping
+
+Interfaces describe the JSON shape returned by `@kozou/api` (node-postgres
+defaults, after JSON serialization):
+
+- `numeric` / `bigint` → `string` (precision is preserved as text)
+- date / time / timestamp → `string` (ISO 8601)
+- `json` / `jsonb` → `unknown`
+- array columns → `T[]`
+- `CHECK (... IN (...))` / enum types → an inline string-literal union
+- anything unrecognised → `unknown`
+- nullable columns → `| null`
+
+## Library use
+
+```ts
+import { emitRowTypes } from '@kozou/codegen';
+
+// `schema` is a SchemaContext from @kozou/introspect + @kozou/core.
+const ts = emitRowTypes(schema);            // pass { header: false } to drop the banner
+```
+
+## CLI
+
+The `kozou` CLI drives `emitRowTypes` through `kozou codegen`. This package
+is an **optional companion** — it is not bundled with the `kozou` CLI — so
+install it alongside `kozou` (or run from a source / workspace checkout):
+
+```bash
+npm install kozou @kozou/codegen
+
+DATABASE_URL=postgres://kozou:kozou@localhost:5432/kozou \
+  kozou codegen --output src/db-types.ts
+```
+
+`--output -` (the default) writes to stdout; `--config <path>` points at a
+`kozou.config.yaml`. Without `@kozou/codegen` installed, `kozou codegen`
+exits with a message telling you to install it.
+
+## License
+
+Apache 2.0

package/dist/emitRowTypes.d.ts

@@ -0,0 +1,7 @@
+import type { SchemaContext } from '@kozou/core';
+export type EmitOptions = {
+    /** Emit the leading "generated by kozou" banner. Default: true. */
+    header?: boolean;
+};
+export declare function emitRowTypes(schema: SchemaContext, opts?: EmitOptions): string;
+//# sourceMappingURL=emitRowTypes.d.ts.map

package/dist/emitRowTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitRowTypes.d.ts","sourceRoot":"","sources":["../src/emitRowTypes.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAA4C,MAAM,aAAa,CAAC;AAG3F,MAAM,MAAM,WAAW,GAAG;IACxB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAWF,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,GAAE,WAAgB,GAAG,MAAM,CAWlF"}

package/dist/emitRowTypes.js

@@ -0,0 +1,107 @@
+// Emit a TypeScript module of row / entity types from a SchemaContext.
+//
+// This is the compiler-native half of Kozou's type story (Kozou v0.2 spec
+// §5.2): one `export interface` per table and view, describing the JSON row a
+// client receives from @kozou/api. It is a pure function — no I/O — so the
+// `kozou codegen` CLI (and tests) drive it directly.
+//
+// Scope: row / entity shapes only. The full API client surface (paths, query
+// params, request/response envelopes, pagination, embeds) is better served by
+// running an OpenAPI generator (e.g. openapi-typescript) against @kozou/api's
+// `GET /openapi.json`, so this package does not reimplement that.
+import { mapColumnType } from './mapType.js';
+const BANNER = [
+    '// Generated by `kozou codegen` from PostgreSQL DDL + COMMENT. Do not edit by hand.',
+    '//',
+    '// Each interface is the JSON row shape returned by @kozou/api: `numeric` /',
+    '// `bigint` are strings (node-postgres preserves precision), and temporal',
+    '// columns are ISO strings. For the full API client surface, run an OpenAPI',
+    "// generator against @kozou/api's `GET /openapi.json`.",
+].join('\n');
+export function emitRowTypes(schema, opts = {}) {
+    const resources = [...schema.tables, ...schema.views];
+    const nameFor = buildNamer(resources);
+    const blocks = resources.map((r) => renderInterface(r, nameFor(r)));
+    const parts = [];
+    if (opts.header !== false)
+        parts.push(BANNER);
+    parts.push(...blocks);
+    // A single trailing newline, no matter how many blocks there are.
+    return parts.join('\n\n') + '\n';
+}
+function renderInterface(resource, name) {
+    const lines = [];
+    const doc = jsDoc(resource.description, 0);
+    if (doc)
+        lines.push(doc);
+    lines.push(`export interface ${name} {`);
+    for (const column of resource.columns) {
+        lines.push(renderField(column));
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+function renderField(column) {
+    const lines = [];
+    const doc = jsDoc(column.description, 2);
+    if (doc)
+        lines.push(doc);
+    const type = mapColumnType(column) + (column.nullable ? ' | null' : '');
+    lines.push(`  ${propertyKey(column.name)}: ${type};`);
+    return lines.join('\n');
+}
+/** Render a COMMENT body as a JSDoc block indented by `indent` spaces, or null
+ *  when there is nothing to say. */
+function jsDoc(description, indent) {
+    if (description === null)
+        return null;
+    const trimmed = description.trim();
+    if (trimmed === '')
+        return null;
+    const pad = ' '.repeat(indent);
+    const body = trimmed.split('\n').map((line) => {
+        // Neutralize the JSDoc terminator: a COMMENT containing `*/` would close
+        // the block early and break the generated TypeScript. Escaping it to `*\/`
+        // keeps the text readable while preventing premature termination. Linear
+        // split/join (no regex) per the CodeQL `js/polynomial-redos` precedent.
+        const safe = line.trimEnd().split('*/').join('*\\/');
+        return `${pad} * ${safe}`.trimEnd();
+    });
+    return [`${pad}/**`, ...body, `${pad} */`].join('\n');
+}
+/** A bare property key when the column name is a plain identifier, otherwise a
+ *  quoted key so the output is always valid TypeScript. */
+function propertyKey(name) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : quotePropertyKey(name);
+}
+function quotePropertyKey(name) {
+    return `'${name.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+}
+/** Resolve each resource to a unique interface name: PascalCase of the bare
+ *  name, qualified with the schema only when the bare name collides. */
+function buildNamer(resources) {
+    const bareCounts = new Map();
+    for (const r of resources) {
+        const bare = pascalCase(r.name);
+        bareCounts.set(bare, (bareCounts.get(bare) ?? 0) + 1);
+    }
+    return (r) => {
+        const bare = pascalCase(r.name);
+        if ((bareCounts.get(bare) ?? 0) > 1) {
+            return `${pascalCase(r.schema)}${bare}`;
+        }
+        return bare;
+    };
+}
+/** Convert an arbitrary SQL identifier to PascalCase, splitting on any run of
+ *  non-alphanumeric characters and guarding against a leading digit. */
+function pascalCase(identifier) {
+    const segments = identifier.split(/[^A-Za-z0-9]+/).filter((s) => s.length > 0);
+    const pascal = segments
+        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+        .join('');
+    if (pascal === '')
+        return '_';
+    return /^[0-9]/.test(pascal) ? `_${pascal}` : pascal;
+}
+//# sourceMappingURL=emitRowTypes.js.map

package/dist/emitRowTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitRowTypes.js","sourceRoot":"","sources":["../src/emitRowTypes.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { emitRowTypes, type EmitOptions } from './emitRowTypes.js';
+export { mapColumnType, mapDataType } from './mapType.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { emitRowTypes } from './emitRowTypes.js';
+export { mapColumnType, mapDataType } from './mapType.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/mapType.d.ts

@@ -0,0 +1,12 @@
+import type { ColumnContext } from '@kozou/core';
+/** A column with an enum domain renders as a union of string literals; every
+ *  other column maps by its PostgreSQL `dataType`. The result never includes
+ *  `| null` — the caller appends that based on `nullable`. */
+export declare function mapColumnType(column: ColumnContext): string;
+/** Map a `format_type(...)` string to a TypeScript type, resolving any array
+ *  suffix to `T[]` and stripping precision/length modifiers first. */
+export declare function mapDataType(dataType: string): string;
+/** Render a string as a single-quoted TypeScript string literal, escaping the
+ *  backslash and single-quote characters. */
+export declare function quoteStringLiteral(value: string): string;
+//# sourceMappingURL=mapType.d.ts.map

package/dist/mapType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapType.d.ts","sourceRoot":"","sources":["../src/mapType.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;8DAE8D;AAC9D,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAK3D;AAED;sEACsE;AACtE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBpD;AA6DD;6CAC6C;AAC7C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/mapType.js

@@ -0,0 +1,99 @@
+// Map a ColumnContext to the TypeScript type that best describes the value a
+// client receives from @kozou/api — i.e. the JSON shape after node-postgres
+// has parsed the row and the response has been serialized. This is why a few
+// mappings may surprise: node-postgres returns `numeric` and `bigint` as
+// strings (to avoid precision loss), and temporal types arrive as ISO strings
+// once a Date has gone through JSON.stringify.
+//
+// Input is the `dataType` produced by @kozou/introspect via PostgreSQL's
+// `format_type(...)`, so the names are the SQL-standard long forms
+// ("character varying", "timestamp with time zone", "double precision", …),
+// optionally carrying a precision/length and a trailing `[]` for arrays.
+/** A column with an enum domain renders as a union of string literals; every
+ *  other column maps by its PostgreSQL `dataType`. The result never includes
+ *  `| null` — the caller appends that based on `nullable`. */
+export function mapColumnType(column) {
+    if (column.enumValues && column.enumValues.length > 0) {
+        return column.enumValues.map(quoteStringLiteral).join(' | ');
+    }
+    return mapDataType(column.dataType);
+}
+/** Map a `format_type(...)` string to a TypeScript type, resolving any array
+ *  suffix to `T[]` and stripping precision/length modifiers first. */
+export function mapDataType(dataType) {
+    let base = dataType.trim();
+    // Peel a (single-level) array suffix; PostgreSQL renders multi-dimensional
+    // arrays with the same element type, so `T[]` is the faithful TS shape.
+    let isArray = false;
+    while (base.endsWith('[]')) {
+        isArray = true;
+        base = base.slice(0, -2).trim();
+    }
+    // Drop every `(...)` modifier ("numeric(12,2)", "timestamp(6) with time
+    // zone", "character varying(255)") and normalize whitespace + case. The
+    // paren stripping is a linear scan rather than a regex so it stays O(n) on
+    // adversarial input like a long run of "(" (no super-linear backtracking).
+    const normalized = collapseWhitespace(stripParenGroups(base)).toLowerCase();
+    const element = SCALAR_TYPE_MAP[normalized] ?? 'unknown';
+    return isArray ? `${element}[]` : element;
+}
+/** Remove every parenthesized group (including nested ones), keeping only the
+ *  characters at paren-depth zero. Single linear pass, no backtracking. */
+function stripParenGroups(input) {
+    let out = '';
+    let depth = 0;
+    for (const ch of input) {
+        if (ch === '(') {
+            depth += 1;
+        }
+        else if (ch === ')') {
+            if (depth > 0)
+                depth -= 1;
+        }
+        else if (depth === 0) {
+            out += ch;
+        }
+    }
+    return out;
+}
+/** Collapse runs of whitespace to a single space and trim. `\s+` (unanchored,
+ *  single repetition) matches linearly, so this is not a ReDoS vector. */
+function collapseWhitespace(input) {
+    return input.replace(/\s+/g, ' ').trim();
+}
+const SCALAR_TYPE_MAP = {
+    // Textual + identifier types.
+    uuid: 'string',
+    text: 'string',
+    'character varying': 'string',
+    character: 'string',
+    '"char"': 'string',
+    bpchar: 'string',
+    citext: 'string',
+    name: 'string',
+    // Integers and floats fit in a JS number.
+    smallint: 'number',
+    integer: 'number',
+    real: 'number',
+    'double precision': 'number',
+    // node-postgres returns these as strings to preserve precision/range.
+    numeric: 'string',
+    bigint: 'string',
+    boolean: 'boolean',
+    // Temporal values arrive as ISO strings once a Date is JSON-serialized.
+    date: 'string',
+    'timestamp without time zone': 'string',
+    'timestamp with time zone': 'string',
+    'time without time zone': 'string',
+    'time with time zone': 'string',
+    interval: 'string',
+    // Structured payloads are parsed objects of an unknown shape.
+    json: 'unknown',
+    jsonb: 'unknown',
+};
+/** Render a string as a single-quoted TypeScript string literal, escaping the
+ *  backslash and single-quote characters. */
+export function quoteStringLiteral(value) {
+    return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+}
+//# sourceMappingURL=mapType.js.map

package/dist/mapType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapType.js","sourceRoot":"","sources":["../src/mapType.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,44 @@
 {
   "name": "@kozou/codegen",
-  "version": "0.0.1",
-  "description": "Placeholder; the experimental 0.2.1 release lands via CI shortly.",
+  "version": "1.0.0",
+  "description": "Kozou TypeScript codegen: emit row / entity types from a SchemaContext (experimental).",
   "license": "Apache-2.0",
-  "publishConfig": { "access": "public" }
-}
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kozou-dev/kozou.git",
+    "directory": "packages/codegen"
+  },
+  "homepage": "https://kozou.org",
+  "bugs": {
+    "url": "https://github.com/kozou-dev/kozou/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@kozou/core": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "@kozou/introspect": "1.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.test.json",
+    "build": "tsc",
+    "test": "vitest run --coverage"
+  }
+}