sheet-to-schema 1.0.0-rc.2 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nizamudeen
+
+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

@@ -12,7 +12,7 @@ one record per row, or per group of rows, reporting every cell it could not use.
 - **The same engine on both sides.** A file imports to the same records in the browser and
   on the server, because both run the same function over the same plan.
 
-> **Status: release candidate (1.0.0-rc.2).** It is the import engine of
+> **Status: stable (1.0.0).** It is the import engine of
 > [Dynamic Entity](https://github.com/berserker5619/Dynamic-Entity#readme) 3.0, extracted so it can be used without it.
 > Members marked `@internal` are not covered by semver and may change in any release.
 
@@ -26,7 +26,7 @@ npm install busboy    # to receive uploads
 npm install express   # for the ready-made router
 ```
 
-Node 18 or later for the main entry; the three packages above are optional peers, loaded the
+Node 20 or later for the main entry; the three packages above are optional peers, loaded the
 first time they are needed. Reading a CSV needs none of them.
 
 ## Quick start
@@ -188,6 +188,18 @@ app.use(
 Without Express, call `runImport`, `previewSheet`, `writeTemplate` and `receiveUpload`
 yourself; the router is a few lines over them.
 
+The typings need nothing from `@types/express`: the router, request and response are typed by
+what the router uses (`ImportRouter`, `ImportRequest`, `ImportResponse`), and an Express 4 or 5
+router fits them. A callback that needs more of the request annotates it, and the options take
+that type:
+
+```ts
+createImportRouter(express.Router(), {
+  bindings: (name, request: express.Request & { tenant: string }) => loadBinding(request.tenant, name),
+  onImport: async (records, { request }) => saveAll(request.tenant, records), // request is typed the same
+});
+```
+
 Four things to know before deploying it:
 
 1. **An import is not transactional.** A file that fails at row 30,000 has written 29,999

package/dist/index.d.mts

@@ -706,7 +706,7 @@ declare function exampleJsonAdapter(sample: unknown, options?: ExampleJsonAdapte
 /**
  * csv.ts — RFC 4180 parse and emit, with no dependency.
  *
- * Moved from Dynamic Entity's `@dynamic-entity/core`, which re-exports it (docs/phase2-plan.md).
+ * Moved from Dynamic Entity's `@dynamic-entity/core`, which re-exports it (https://github.com/berserker5619/Dynamic-Entity/blob/main/docs/phase2-plan.md).
  *
  * Why this is here rather than left to the consumer: a spreadsheet import that needs a
  * parser installed before it does anything is a feature with a prerequisite. CSV is the
@@ -967,7 +967,7 @@ interface ImportErrorResponse {
  * A client compares it with its own at major.minor, to notice that the two halves of an import
  * have moved apart. `version.spec.ts` holds it equal to `package.json`.
  */
-declare const IMPORTER_VERSION = "1.0.0-rc.2";
+declare const IMPORTER_VERSION = "1.0.0";
 /** The plan versions this package reads: v1, with no `planVersion`, and v2. */
 declare const PLAN_VERSIONS: readonly number[];
 

package/dist/index.d.ts

@@ -706,7 +706,7 @@ declare function exampleJsonAdapter(sample: unknown, options?: ExampleJsonAdapte
 /**
  * csv.ts — RFC 4180 parse and emit, with no dependency.
  *
- * Moved from Dynamic Entity's `@dynamic-entity/core`, which re-exports it (docs/phase2-plan.md).
+ * Moved from Dynamic Entity's `@dynamic-entity/core`, which re-exports it (https://github.com/berserker5619/Dynamic-Entity/blob/main/docs/phase2-plan.md).
  *
  * Why this is here rather than left to the consumer: a spreadsheet import that needs a
  * parser installed before it does anything is a feature with a prerequisite. CSV is the
@@ -967,7 +967,7 @@ interface ImportErrorResponse {
  * A client compares it with its own at major.minor, to notice that the two halves of an import
  * have moved apart. `version.spec.ts` holds it equal to `package.json`.
  */
-declare const IMPORTER_VERSION = "1.0.0-rc.2";
+declare const IMPORTER_VERSION = "1.0.0";
 /** The plan versions this package reads: v1, with no `planVersion`, and v2. */
 declare const PLAN_VERSIONS: readonly number[];
 

package/dist/index.js

@@ -1199,7 +1199,7 @@ function suggestMapping(headers, adapter, options = {}) {
 }
 
 // src/version.ts
-var IMPORTER_VERSION = "1.0.0-rc.2";
+var IMPORTER_VERSION = "1.0.0";
 var PLAN_VERSIONS = [1, 2];
 
 // src/json-schema-adapter.ts