@homeflare/alchemy 0.27.4 → 0.29.0

package/dist/paperless/custom-field.d.ts

@@ -7,27 +7,26 @@
  *   this refusal generically; `dataType` is simply never listed in `fields`, so nothing in
  *   `matching.ts` ever builds a PATCH body that includes it.
  *
- * ⛔ NO `owner` FIELD. Unlike `Tag`/`DocumentType`/`StoragePath`, `CustomField` does not extend
- *   Paperless-ngx's `OwnedObjectSerializer` — its wire body is exactly `{name, data_type,
- *   extra_data}` (measured against the v3.1.1 schema). `owned: false` stops `matching.ts`
- *   sending a field the vendor's serializer does not declare.
+ * ⛔ NO `owner` FIELD, AND NO `ownerOf` SPEC ENTRY. Unlike `Tag`/`DocumentType`/`StoragePath`,
+ *   `CustomField` does not extend Paperless-ngx's `OwnedObjectSerializer` — its wire body is
+ *   exactly `{name, data_type, extra_data}` (measured against the v3.1.1 schema, and confirmed
+ *   again in `@distilled.cloud/paperless-ngx`'s generated `custom_fields.ts`, which has no
+ *   `owner` field either). `owned: false` stops `matching.ts` sending or comparing one.
  *
  * ⚠️ `CustomField.select_options` (the vendor's own rule for a `select` field's option list) is
- *   not in the served schema at all, so it is recorded here and NOT enforced (groundTruth).
+ *   not in the served schema at all, so it is recorded here and NOT enforced (groundTruth). See
+ *   `tag.ts`'s header for the 2026-09-24 transport migration this file follows.
  */
 import { Resource } from 'alchemy';
 import * as Provider from 'alchemy/Provider';
+import * as customFields from '@distilled.cloud/paperless-ngx/custom_fields';
 import * as Effect from 'effect/Effect';
 import type { PaperlessCustomFieldRequest } from './generated/types/custom-fields.ts';
-import type { PaperlessRow } from './client.ts';
-import { type MatchingRequirements } from './matching.ts';
+import { type MatchingRequirements, type MatchingSpec } from './matching.ts';
 export interface CustomFieldProps {
-    /** ⚠️ maxLength 128 (generated constraint table). The locate key — CustomField's name is globally unique (models.py:1169), with no owner to further scope it. */
+    /** ⚠️ maxLength 128 (generated constraint table). CustomField's name is globally unique (models.py:1169), with no owner to further scope it. */
     name: string;
-    /**
-     * ⛔ CREATE-ONLY — see this file's header. `select`'s own option list
-     *   (`select_options`) is not in the vendor schema and is unenforced here.
-     */
+    /** ⛔ CREATE-ONLY — see this file's header. `select`'s own option list (`select_options`) is not in the vendor schema and is unenforced here. */
     dataType: PaperlessCustomFieldRequest['data_type'];
     /** Arbitrary JSON the vendor attaches no schema to (e.g. a `select` field's option list). */
     extraData?: unknown;
@@ -42,16 +41,17 @@ export interface CustomField extends Resource<'Paperless.CustomField', CustomFie
 }
 export declare const CustomField: import("alchemy").ResourceClass<CustomField>;
 /**
- * ⛔ EXTRACTED SO IT CAN BE TESTED WITHOUT A SERVER (custom-field.test.ts) — the same reason
- *   `../netbox/prefix-form.ts` pulls its body/matches functions out of `prefix.ts`.
+ * ⛔ EXTRACTED SO IT CAN BE TESTED WITHOUT A SERVER (custom-field.test.ts). `Pick<…, 'data_type'>`
+ *   rather than the full `CustomField`, so a test fixture need not spell out `name`/`document_count`.
  */
-export declare const dataTypeImmutable: (live: PaperlessRow, props: CustomFieldProps) => string | undefined;
-/** ⚠️ Exported (not through index.ts) so custom-field.test.ts can drive the real lifecycle. */
+export declare const dataTypeImmutable: (live: Pick<customFields.CustomField, 'data_type'>, props: CustomFieldProps) => string | undefined;
+/** ★ Exported for direct testing — see tag.ts's own note on this seam. */
+export declare const spec: MatchingSpec<CustomFieldProps, customFields.CustomField, CustomFieldAttributes, customFields.CreateCustomFieldError | customFields.GetCustomFieldError | customFields.ListCustomFieldsError | customFields.UpdateCustomFieldsPartialError | customFields.CustomFieldsDestroyError>;
 export declare const customFieldHandlers: {
     list: () => Effect.Effect<never[], never, never>;
     read: ({ olds }: {
         olds: CustomFieldProps;
-    }) => Effect.Effect<CustomFieldAttributes | undefined, import("./credentials.ts").PaperlessCredentialsError | import("./errors.ts").PaperlessUnauthorized | import("./errors.ts").PaperlessUnavailable | import("./errors.ts").PaperlessValidation, import("./client.ts").PaperlessRequirements>;
+    }) => Effect.Effect<CustomFieldAttributes | undefined, import("@distilled.cloud/caddy").BadGateway | customFields.BadRequest | import("@distilled.cloud/caddy").ConfigError | customFields.Forbidden | import("@distilled.cloud/caddy").GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | import("@distilled.cloud/caddy").InternalServerError | customFields.NotFound | import("@distilled.cloud/paperless-ngx/Errors").PaperlessNgxParseError | import("@distilled.cloud/caddy").ServiceUnavailable | import("@distilled.cloud/caddy").TooManyRequests | import("@distilled.cloud/caddy").Unauthorized | import("@distilled.cloud/paperless-ngx/Errors").UnknownPaperlessNgxError, import("effect/unstable/http/HttpClient").HttpClient>;
     diff: ({ news, output }: {
         news: import("alchemy").Input<CustomFieldProps>;
         output: CustomFieldAttributes | undefined;
@@ -61,15 +61,15 @@ export declare const customFieldHandlers: {
         readonly action: 'noop';
     } | {
         readonly action: 'replace';
-    } | undefined, import("./credentials.ts").PaperlessCredentialsError | import("./errors.ts").PaperlessUnauthorized | import("./errors.ts").PaperlessUnavailable | import("./errors.ts").PaperlessValidation, import("./client.ts").PaperlessRequirements>;
+    } | undefined, import("@distilled.cloud/caddy").BadGateway | customFields.BadRequest | import("@distilled.cloud/caddy").ConfigError | customFields.Forbidden | import("@distilled.cloud/caddy").GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | import("@distilled.cloud/caddy").InternalServerError | customFields.NotFound | import("@distilled.cloud/paperless-ngx/Errors").PaperlessNgxParseError | import("@distilled.cloud/caddy").ServiceUnavailable | import("@distilled.cloud/caddy").TooManyRequests | import("@distilled.cloud/caddy").Unauthorized | import("@distilled.cloud/paperless-ngx/Errors").UnknownPaperlessNgxError, import("effect/unstable/http/HttpClient").HttpClient>;
     reconcile: ({ news, output }: {
         news: CustomFieldProps;
         output?: CustomFieldAttributes | undefined;
-    }) => Effect.Effect<CustomFieldAttributes, import("./credentials.ts").PaperlessCredentialsError | import("./errors.ts").PaperlessError, import("./client.ts").PaperlessRequirements>;
+    }) => Effect.Effect<CustomFieldAttributes, import("@distilled.cloud/caddy").BadGateway | customFields.BadRequest | import("@distilled.cloud/caddy").ConfigError | customFields.Forbidden | import("@distilled.cloud/caddy").GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | import("@distilled.cloud/caddy").InternalServerError | customFields.NotFound | import("@distilled.cloud/paperless-ngx/Errors").PaperlessNgxParseError | import("@distilled.cloud/caddy").ServiceUnavailable | import("@distilled.cloud/caddy").TooManyRequests | import("@distilled.cloud/caddy").Unauthorized | import("@distilled.cloud/paperless-ngx/Errors").UnknownPaperlessNgxError, import("effect/unstable/http/HttpClient").HttpClient>;
     delete: ({ olds, output }: {
         olds: CustomFieldProps;
         output?: CustomFieldAttributes | undefined;
-    }) => Effect.Effect<void, import("./credentials.ts").PaperlessCredentialsError | import("./errors.ts").PaperlessUnauthorized | import("./errors.ts").PaperlessUnavailable | import("./errors.ts").PaperlessValidation, import("./client.ts").PaperlessRequirements>;
+    }) => Effect.Effect<void, import("@distilled.cloud/caddy").BadGateway | customFields.BadRequest | import("@distilled.cloud/caddy").ConfigError | customFields.Forbidden | import("@distilled.cloud/caddy").GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | import("@distilled.cloud/caddy").InternalServerError | customFields.NotFound | import("@distilled.cloud/paperless-ngx/Errors").PaperlessNgxParseError | import("@distilled.cloud/caddy").ServiceUnavailable | import("@distilled.cloud/caddy").TooManyRequests | import("@distilled.cloud/caddy").Unauthorized | import("@distilled.cloud/paperless-ngx/Errors").UnknownPaperlessNgxError, import("effect/unstable/http/HttpClient").HttpClient>;
 };
-export declare const CustomFieldProvider: () => import("effect/Layer").Layer<Provider.Provider<CustomField>, never, import("./client.ts").PaperlessRequirements>;
+export declare const CustomFieldProvider: () => import("effect/Layer").Layer<Provider.Provider<CustomField>, never, import("effect/unstable/http/HttpClient").HttpClient>;
 //# sourceMappingURL=custom-field.d.ts.map

package/dist/paperless/custom-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-field.d.ts","sourceRoot":"","sources":["../../src/paperless/custom-field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,KAAK,oBAAoB,EAAoB,MAAM,eAAe,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,iKAAiK;IACjK,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,2BAA2B,CAAC,WAAW,CAAC,CAAC;IACnD,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAC3C,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,EACL,oBAAoB,CACrB;CAAG;AAEJ,eAAO,MAAM,WAAW,8CAEtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,SACtB,YAAY,SACX,gBAAgB,KACtB,MAAM,GAAG,SAKG,CAAC;AAEhB,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;CAqB9B,CAAC;AAEH,eAAO,MAAM,mBAAmB,wHAC4D,CAAC"}
+{"version":3,"file":"custom-field.d.ts","sourceRoot":"","sources":["../../src/paperless/custom-field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,8CAA8C,CAAC;AAC7E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACtF,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAElB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,gBAAgB;IAC/B,gJAAgJ;IAChJ,IAAI,EAAE,MAAM,CAAC;IACb,gJAAgJ;IAChJ,QAAQ,EAAE,2BAA2B,CAAC,WAAW,CAAC,CAAC;IACnD,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAC3C,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,EACL,oBAAoB,CACrB;CAAG;AAEJ,eAAO,MAAM,WAAW,8CAEtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,SACtB,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,WAAW,CAAC,SAC1C,gBAAgB,KACtB,MAAM,GAAG,SAKG,CAAC;AAEhB,0EAA0E;AAC1E,eAAO,MAAM,IAAI,EAAE,YAAY,CAC7B,gBAAgB,EAChB,YAAY,CAAC,WAAW,EACxB,qBAAqB,EACnB,YAAY,CAAC,sBAAsB,GACnC,YAAY,CAAC,mBAAmB,GAChC,YAAY,CAAC,qBAAqB,GAClC,YAAY,CAAC,8BAA8B,GAC3C,YAAY,CAAC,wBAAwB,CA+BxC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;CAAyB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,iIAC4D,CAAC"}

package/dist/paperless/document-type.d.ts

@@ -1,15 +1,19 @@
 /**
  * `Paperless.DocumentType` — a Paperless-ngx document type, create-or-update and never deleted.
  * Same shape as `tag.ts` minus `color`/`isInboxTag`/`parent` — see that file's header for why
- * `matchingAlgorithm`'s type comes off the generated request type rather than being retyped.
+ * `matchingAlgorithm`'s type comes off the generated request type rather than being retyped, and
+ * for the 2026-09-24 transport migration this file follows exactly.
  */
 import { Resource } from 'alchemy';
 import * as Provider from 'alchemy/Provider';
+import * as documentTypes from '@distilled.cloud/paperless-ngx/document_types';
+import * as Effect from 'effect/Effect';
 import type { PaperlessDocumentTypeRequest } from './generated/types/document-types.ts';
-import { type MatchingProps, type MatchingRequirements } from './matching.ts';
-export interface DocumentTypeProps extends MatchingProps {
+import { type MatchingRequirements, type MatchingSpec } from './matching.ts';
+export interface DocumentTypeProps {
     /** ⚠️ maxLength 128 (generated constraint table). The locate key. */
     name: string;
+    owner?: number;
     /** ⚠️ maxLength 256. */
     match?: string;
     matchingAlgorithm?: PaperlessDocumentTypeRequest['matching_algorithm'];
@@ -26,5 +30,31 @@ export interface DocumentTypeAttributes {
 export interface DocumentType extends Resource<'Paperless.DocumentType', DocumentTypeProps, DocumentTypeAttributes, never, MatchingRequirements> {
 }
 export declare const DocumentType: import("alchemy").ResourceClass<DocumentType>;
-export declare const DocumentTypeProvider: () => import("effect/Layer").Layer<Provider.Provider<DocumentType>, never, import("./client.ts").PaperlessRequirements>;
+/** ★ Exported for direct testing — see tag.ts's own note on this seam. */
+export declare const spec: MatchingSpec<DocumentTypeProps, documentTypes.DocumentType, DocumentTypeAttributes, documentTypes.CreateDocumentTypeError | documentTypes.GetDocumentTypeError | documentTypes.ListDocumentTypesError | documentTypes.UpdateDocumentTypesPartialError | documentTypes.DocumentTypesDestroyError>;
+export declare const handlers: {
+    list: () => Effect.Effect<never[], never, never>;
+    read: ({ olds }: {
+        olds: DocumentTypeProps;
+    }) => Effect.Effect<DocumentTypeAttributes | undefined, import("@distilled.cloud/caddy").BadGateway | documentTypes.BadRequest | import("@distilled.cloud/caddy").ConfigError | documentTypes.Forbidden | import("@distilled.cloud/caddy").GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | import("@distilled.cloud/caddy").InternalServerError | documentTypes.NotFound | import("@distilled.cloud/paperless-ngx/Errors").PaperlessNgxParseError | import("@distilled.cloud/caddy").ServiceUnavailable | import("@distilled.cloud/caddy").TooManyRequests | import("@distilled.cloud/caddy").Unauthorized | import("@distilled.cloud/paperless-ngx/Errors").UnknownPaperlessNgxError, import("effect/unstable/http/HttpClient").HttpClient>;
+    diff: ({ news, output }: {
+        news: import("alchemy").Input<DocumentTypeProps>;
+        output: DocumentTypeAttributes | undefined;
+    }) => Effect.Effect<{
+        readonly action: 'update';
+    } | {
+        readonly action: 'noop';
+    } | {
+        readonly action: 'replace';
+    } | undefined, import("@distilled.cloud/caddy").BadGateway | documentTypes.BadRequest | import("@distilled.cloud/caddy").ConfigError | documentTypes.Forbidden | import("@distilled.cloud/caddy").GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | import("@distilled.cloud/caddy").InternalServerError | documentTypes.NotFound | import("@distilled.cloud/paperless-ngx/Errors").PaperlessNgxParseError | import("@distilled.cloud/caddy").ServiceUnavailable | import("@distilled.cloud/caddy").TooManyRequests | import("@distilled.cloud/caddy").Unauthorized | import("@distilled.cloud/paperless-ngx/Errors").UnknownPaperlessNgxError, import("effect/unstable/http/HttpClient").HttpClient>;
+    reconcile: ({ news, output }: {
+        news: DocumentTypeProps;
+        output?: DocumentTypeAttributes | undefined;
+    }) => Effect.Effect<DocumentTypeAttributes, import("@distilled.cloud/caddy").BadGateway | documentTypes.BadRequest | import("@distilled.cloud/caddy").ConfigError | documentTypes.Forbidden | import("@distilled.cloud/caddy").GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | import("@distilled.cloud/caddy").InternalServerError | documentTypes.NotFound | import("@distilled.cloud/paperless-ngx/Errors").PaperlessNgxParseError | import("@distilled.cloud/caddy").ServiceUnavailable | import("@distilled.cloud/caddy").TooManyRequests | import("@distilled.cloud/caddy").Unauthorized | import("@distilled.cloud/paperless-ngx/Errors").UnknownPaperlessNgxError, import("effect/unstable/http/HttpClient").HttpClient>;
+    delete: ({ olds, output }: {
+        olds: DocumentTypeProps;
+        output?: DocumentTypeAttributes | undefined;
+    }) => Effect.Effect<void, import("@distilled.cloud/caddy").BadGateway | documentTypes.BadRequest | import("@distilled.cloud/caddy").ConfigError | documentTypes.Forbidden | import("@distilled.cloud/caddy").GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | import("@distilled.cloud/caddy").InternalServerError | documentTypes.NotFound | import("@distilled.cloud/paperless-ngx/Errors").PaperlessNgxParseError | import("@distilled.cloud/caddy").ServiceUnavailable | import("@distilled.cloud/caddy").TooManyRequests | import("@distilled.cloud/caddy").Unauthorized | import("@distilled.cloud/paperless-ngx/Errors").UnknownPaperlessNgxError, import("effect/unstable/http/HttpClient").HttpClient>;
+};
+export declare const DocumentTypeProvider: () => import("effect/Layer").Layer<Provider.Provider<DocumentType>, never, import("effect/unstable/http/HttpClient").HttpClient>;
 //# sourceMappingURL=document-type.d.ts.map

package/dist/paperless/document-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-type.d.ts","sourceRoot":"","sources":["../../src/paperless/document-type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAoB,MAAM,eAAe,CAAC;AAEhG,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,4BAA4B,CAAC,oBAAoB,CAAC,CAAC;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ,CAC5C,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,EACL,oBAAoB,CACrB;CAAG;AAEJ,eAAO,MAAM,YAAY,+CAEvB,CAAC;AAiCH,eAAO,MAAM,oBAAoB,yHACkD,CAAC"}
+{"version":3,"file":"document-type.d.ts","sourceRoot":"","sources":["../../src/paperless/document-type.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,aAAa,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAElB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,4BAA4B,CAAC,oBAAoB,CAAC,CAAC;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ,CAC5C,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,EACL,oBAAoB,CACrB;CAAG;AAEJ,eAAO,MAAM,YAAY,+CAEvB,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,IAAI,EAAE,YAAY,CAC7B,iBAAiB,EACjB,aAAa,CAAC,YAAY,EAC1B,sBAAsB,EACpB,aAAa,CAAC,uBAAuB,GACrC,aAAa,CAAC,oBAAoB,GAClC,aAAa,CAAC,sBAAsB,GACpC,aAAa,CAAC,+BAA+B,GAC7C,aAAa,CAAC,yBAAyB,CAuC1C,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;CAAyB,CAAC;AAE/C,eAAO,MAAM,oBAAoB,kIACkD,CAAC"}

package/dist/paperless/fake-paperless.d.ts

@@ -1,39 +1,56 @@
 /**
- * A fake Paperless-ngx for the tests beside it — `Bun.serve` on an ephemeral 127.0.0.1 port, the
- * same shape `../openbao/fake-bao.ts` and `../caddy/fake-caddy.ts` use.
+ * A minimal in-memory Paperless-ngx REST API for this family's tests — an in-memory `fetch`
+ * handed to Effect's real `FetchHttpClient` through its `Fetch` reference, mirroring
+ * `../netbox/fake-netbox.ts` and `../forgejo/fake-forgejo.ts`. Tests exercise distilled's REAL
+ * path assembly, JSON encode/decode and status→typed-error matching (`404` → `NotFound`, `403` →
+ * `Forbidden`, `400` → `BadRequest`, …) — nothing about that matching is re-implemented here, only
+ * the wire responses and in-memory rows a scenario needs.
  *
- * ⛔ TEST-ONLY. No provider imports this file. It stores rows in memory for exactly the four
- *   taxonomy collections and answers `name__iexact` the way Django does — case-insensitive,
- *   never collapsing two differently-cased rows into one.
+ * ⛔ TEST-ONLY, AND NO NETWORK. No provider imports this file. Stores rows in memory for the four
+ *   taxonomy collections and answers `name__iexact` the way Django does — case-insensitive, never
+ *   collapsing two differently-cased rows into one. Ported from the pre-migration `Bun.serve`
+ *   fake: production now goes through `@distilled.cloud/paperless-ngx`'s `CredentialsFromEnv`,
+ *   which resolves through Effect `Config` and snapshots `process.env` once (measured in the
+ *   forgejo migration, kit PR 180) — a test can no longer point production code at a fake server
+ *   by mutating env vars, so this hands an explicit `credentials()` layer instead.
  */
+import { type Credentials } from '@distilled.cloud/paperless-ngx/Credentials';
+import type { PaperlessNgxOpContext } from '@distilled.cloud/paperless-ngx/Protocol';
 import * as Effect from 'effect/Effect';
-import type { PaperlessRequirements } from './client.ts';
-import { type PaperlessCredentialsError } from './credentials.ts';
-import type { PaperlessError } from './errors.ts';
-export declare const FAKE_TOKEN = "fake-token-not-real";
+import * as Layer from 'effect/Layer';
+export declare const FAKE_BASE = "https://paperless.example.com";
+export declare const FAKE_TOKEN = "placeholder-paperless-token";
 export interface Seen {
     readonly method: string;
     readonly path: string;
-    readonly headers: Headers;
     readonly body: string;
 }
 export type Row = Record<string, unknown> & {
     id: number;
 };
 declare const COLLECTIONS: readonly ['tags', 'document_types', 'storage_paths', 'custom_fields'];
+type Collection = (typeof COLLECTIONS)[number];
 export interface FakePaperless {
-    readonly url: string;
+    readonly fetch: typeof globalThis.fetch;
     readonly seen: Seen[];
-    readonly rows: (collection: (typeof COLLECTIONS)[number]) => readonly Row[];
-    /** `undefined` to answer normally; a status to force it once per subsequent call. */
+    readonly rows: (collection: Collection) => readonly Row[];
+    /** `undefined` to answer normally; a status to force it once for the NEXT call only. */
     forceStatus: number | undefined;
-    stop(): void;
 }
+/**
+ * A stateful CRUD router across the four collections — this is what makes it possible to test
+ * `matching.ts`'s full create → read-back → PATCH → DELETE lifecycle, not just one canned
+ * response per test the way `fakeNetbox`/`fakeForgejo`'s simpler `route` callback does.
+ */
 export declare const fakePaperless: () => FakePaperless;
-/** Run `body` against a fresh fake, `PAPERLESS_URL`/`PAPERLESS_TOKEN` set only for its duration. */
-export declare const withFake: (body: (fake: FakePaperless) => Promise<void>) => Promise<void>;
-/** Run an effect through the real `FetchHttpClient` and the real environment credentials layer. */
-export declare const run: <A>(effect: Effect.Effect<A, PaperlessError | PaperlessCredentialsError, PaperlessRequirements>) => Promise<A>;
-export declare const runFailure: <A>(effect: Effect.Effect<A, PaperlessError | PaperlessCredentialsError, PaperlessRequirements>) => Promise<PaperlessCredentialsError | PaperlessError>;
+/**
+ * distilled Credentials + the real FetchHttpClient over the fake — `PaperlessNgxOpContext`, what
+ * `matchingOperations(spec)` (matching.ts, unwrapped — not `matchingHandlers`, which bakes in
+ * `CredentialsFromEnv` and so cannot be pointed at a fake server, per this file's own header)
+ * needs to run against a fake.
+ */
+export declare const fakePaperlessLayer: (fetchFn: typeof globalThis.fetch, creds?: Layer.Layer<Credentials>) => Layer.Layer<Credentials | import("effect/unstable/http/HttpClient").HttpClient, never, never>;
+export declare const run: <A, E>(effect: Effect.Effect<A, E, PaperlessNgxOpContext>, fetchFn: typeof globalThis.fetch) => Promise<A>;
+export declare const runFailure: <A, E>(effect: Effect.Effect<A, E, PaperlessNgxOpContext>, fetchFn: typeof globalThis.fetch) => Promise<E>;
 export {};
 //# sourceMappingURL=fake-paperless.d.ts.map

package/dist/paperless/fake-paperless.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fake-paperless.d.ts","sourceRoot":"","sources":["../../src/paperless/fake-paperless.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,KAAK,yBAAyB,EAAoB,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,UAAU,wBAAwB,CAAC;AAEhD,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,QAAA,MAAM,WAAW,YAAI,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,CAAU,CAAC;AAE1F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,SAAS,GAAG,EAAE,CAAC;IAC5E,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,IAAI,IAAI,CAAC;CACd;AAKD,eAAO,MAAM,aAAa,QAAO,aA0EhC,CAAC;AAQF,oGAAoG;AACpG,eAAO,MAAM,QAAQ,SAAgB,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,IAAI,CAezF,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,GAAG,GAAI,CAAC,UACX,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,GAAG,yBAAyB,EAAE,qBAAqB,CAAC,eAI1F,CAAC;AAEJ,eAAO,MAAM,UAAU,GAAI,CAAC,UAClB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,GAAG,yBAAyB,EAAE,qBAAqB,CAAC,wDAO1F,CAAC"}
+{"version":3,"file":"fake-paperless.d.ts","sourceRoot":"","sources":["../../src/paperless/fake-paperless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,4CAA4C,CAAC;AAC3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,eAAO,MAAM,SAAS,kCAAkC,CAAC;AACzD,eAAO,MAAM,UAAU,gCAAgC,CAAC;AAExD,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,QAAA,MAAM,WAAW,YAAI,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,CAAU,CAAC;AAC1F,KAAK,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,SAAS,GAAG,EAAE,CAAC;IAC1D,wFAAwF;IACxF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAWD;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAO,aAmEhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,YACpB,OAAO,UAAU,CAAC,KAAK,UACzB,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,kGAC+D,CAAC;AAEjG,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,UACd,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC,WACzC,OAAO,UAAU,CAAC,KAAK,eAC8C,CAAC;AAEjF,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,UACrB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC,WACzC,OAAO,UAAU,CAAC,KAAK,eAC2D,CAAC"}

package/dist/paperless/index.d.ts

@@ -5,9 +5,14 @@
  *   header. `matching.ts`'s internals and the raw generated modules are not re-exported; a
  *   consumer wanting the same guard a Resource uses gets it through `constraintsFor`/
  *   `bodyViolations`, not by importing `generated/` directly.
+ *
+ * 🔴 `PaperlessCredentials`/`PaperlessError` AND FRIENDS ARE GONE (2026-09-24, the
+ *   `@distilled.cloud/paperless-ngx` migration — matching.ts's header), the same way
+ *   `../netbox/index.ts` dropped `NetboxError`/`apiBase` in its own migration. A caller that
+ *   needs the typed errors now imports them from `@distilled.cloud/paperless-ngx` directly (e.g.
+ *   `@distilled.cloud/paperless-ngx/tags`'s `NotFound`); nothing in this estate imported the old
+ *   names (measured 2026-09-24).
  */
-export { PaperlessCredentials, type PaperlessCredentialValue, PaperlessCredentialsError, environmentLayer as paperlessEnvironmentLayer, } from './credentials.ts';
-export { PaperlessNotFound, PaperlessUnauthorized, PaperlessValidation, PaperlessUnavailable, type PaperlessError, } from './errors.ts';
 export { PAPERLESS_CONSTRAINTS, bodyViolations, constraintsFor, guardBody, } from './constraint-guard.ts';
 export { type EndpointConstraints, type EndpointKey, type ParamConstraint, type PaperlessBody, refusal, violations, } from './constraints.ts';
 export { PAPERLESS_CONSTRAINTS_DIGEST } from './generated/constraints/index.ts';

package/dist/paperless/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/paperless/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,gBAAgB,IAAI,yBAAyB,GAC9C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,SAAS,GACV,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,OAAO,EACP,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/paperless/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,SAAS,GACV,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,OAAO,EACP,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}